Add global execution summary endpoint to alerting API (elastic#216477)

## Summary

Added an internal endpoint `GET
/internal/alerting/_global_execution_summary` to fetch an execution
summary with the following shape:
```
{
  "executions": {
    "total": 18,
    "success": 18
  },
  "latestExecutionSummary": {
    "success": 2,
    "failure": 0,
    "warning": 0
  }
}
```
The `latestExecutionSummary` contains a counter of the outcome of the
latest execution of each individual rule.

## How was this tested?
I ran the Kibana locally, created two rules in two different spaces and
called the endpoint for each space.

## Why not using the existing endpoint `GET
/internal/alerting/_global_execution_kpi`?
The existing endpoint has a [hard
limit](https://github.com/elastic/kibana/blob/main/x-pack/platform/plugins/shared/alerting/server/lib/get_execution_log_aggregation.ts#L619)
of 10k which can be easily hit in real scenarios. The limit exists
because the results returned in the aggregations grow linearly with the
amount of executions of a rule.

In our use case we are only returning counters and the status of the
last execution of each rule. Extending the existing endpoint won't give
us the flexibility of having a longer time range (up to 3 days) which we
need to implement the following summary in the frontend:

![image](https://github.com/user-attachments/assets/9cd8f331-1d0c-44b3-8c99-ef513a66b541)

---------

Co-authored-by: kibanamachine <[email protected]>

Author: 2 people

x-pack/platform/plugins/shared/alerting/common/execution_log_types.ts

@@ -38,6 +38,18 @@ export const EMPTY_EXECUTION_KPI_RESULT = {
   triggeredActions: 0,
 };
 
+export const EMPTY_EXECUTION_SUMMARY_RESULT = {
+  executions: {
+    total: 0,
+    success: 0,
+  },
+  latestExecutionSummary: {
+    success: 0,
+    failure: 0,
+    warning: 0,
+  },
+};
+
 export type ExecutionLogSortFields = (typeof executionLogSortableColumns)[number];
 
 export type ActionErrorLogSortFields = (typeof actionErrorLogSortableColumns)[number];

x-pack/platform/plugins/shared/alerting/common/index.ts

@@ -150,6 +150,7 @@ export {
   executionLogSortableColumns,
   actionErrorLogSortableColumns,
   EMPTY_EXECUTION_KPI_RESULT,
+  EMPTY_EXECUTION_SUMMARY_RESULT,
 } from './execution_log_types';
 export type { RuleSnoozeSchedule, RuleSnooze } from './rule_snooze_type';
 export type { RRuleParams, RRuleRecord } from './rrule_type';
@@ -246,6 +247,9 @@ export const INTERNAL_ALERTING_GAPS_GET_SUMMARY_BY_RULE_IDS_API_PATH =
 export const INTERNAL_ALERTING_GAPS_FILL_BY_ID_API_PATH =
   `${INTERNAL_ALERTING_GAPS_API_PATH}/_fill_by_id` as const;
 
+export const INTERNAL_ALERTING_GET_GLOBAL_RULE_EXECUTION_SUMMARY_API_PATH =
+  `${INTERNAL_BASE_ALERTING_API_PATH}/_global_execution_summary` as const;
+
 // External
 export const ARCHIVE_MAINTENANCE_WINDOW_API_PATH = `${BASE_MAINTENANCE_WINDOW_API_PATH}/{id}/_archive`;
 export const UNARCHIVE_MAINTENANCE_WINDOW_API_PATH = `${BASE_MAINTENANCE_WINDOW_API_PATH}/{id}/_unarchive`;

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/global_execution_summary/index.ts

@@ -0,0 +1,27 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+export {
+  getGlobalExecutionSummarySchema,
+  getGlobalExecutionSummaryResponseBodySchema,
+} from './schemas/latest';
+export type {
+  GetGlobalExecutionSummary,
+  GetGlobalExecutionSummaryResponseBody,
+  GetGlobalExecutionSummaryResponse,
+} from './types/latest';
+
+export {
+  getGlobalExecutionSummarySchema as getGlobalExecutionSummarySchemaV1,
+  getGlobalExecutionSummaryResponseBodySchema as getGlobalExecutionSummaryResponseBodySchemaV1,
+} from './schemas/v1';
+
+export type {
+  GetGlobalExecutionSummary as GetGlobalExecutionSummaryV1,
+  GetGlobalExecutionSummaryResponse as GetGlobalExecutionSummaryResponseV1,
+  GetGlobalExecutionSummaryResponseBody as GetGlobalExecutionSummaryResponseBodyV1,
+} from './types/v1';

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/global_execution_summary/schemas/latest.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+export * from './v1';

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/global_execution_summary/schemas/v1.ts

@@ -0,0 +1,45 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { schema } from '@kbn/config-schema';
+
+export const getGlobalExecutionSummarySchema = schema.object(
+  {
+    date_start: schema.string(),
+    date_end: schema.string(),
+  },
+  {
+    validate({ date_start: start, date_end: end }) {
+      const parsedStart = Date.parse(start);
+      if (isNaN(parsedStart)) {
+        return `[start]: query start must be valid date`;
+      }
+
+      const parsedEnd = Date.parse(end);
+      if (isNaN(parsedEnd)) {
+        return `[end]: query end must be valid date`;
+      }
+
+      if (parsedStart >= parsedEnd) {
+        return `[start]: query start must be before end`;
+      }
+    },
+  }
+);
+
+const positiveNumber = schema.number({ min: 0 });
+
+export const getGlobalExecutionSummaryResponseBodySchema = schema.object({
+  executions: schema.object({
+    total: positiveNumber,
+    success: positiveNumber,
+  }),
+  latestExecutionSummary: schema.object({
+    success: positiveNumber,
+    failure: positiveNumber,
+    warning: positiveNumber,
+  }),
+});

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/global_execution_summary/types/latest.ts

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+export * from './v1';

x-pack/platform/plugins/shared/alerting/common/routes/rule/apis/global_execution_summary/types/v1.ts

@@ -0,0 +1,21 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { TypeOf } from '@kbn/config-schema';
+import type {
+  getGlobalExecutionSummarySchema,
+  getGlobalExecutionSummaryResponseBodySchema,
+} from '..';
+
+export type GetGlobalExecutionSummary = TypeOf<typeof getGlobalExecutionSummarySchema>;
+export type GetGlobalExecutionSummaryResponseBody = TypeOf<
+  typeof getGlobalExecutionSummaryResponseBodySchema
+>;
+
+export interface GetGlobalExecutionSummaryResponse {
+  body: GetGlobalExecutionSummaryResponseBody;
+}

x-pack/platform/plugins/shared/alerting/server/lib/__snapshots__/get_execution_log_aggregation.test.ts.snap

@@ -16,6 +16,8 @@ import {
   formatSortForTermSort,
   getExecutionKPIAggregation,
   formatExecutionKPIResult,
+  getExecutionSummaryAggregation,
+  formatExecutionSummaryResult,
 } from './get_execution_log_aggregation';
 
 describe('formatSortForBucketSort', () => {
@@ -2979,3 +2981,70 @@ describe('formatExecutionKPIAggBuckets', () => {
     );
   });
 });
+
+describe('getExecutionSummaryAggregation', () => {
+  test('should correctly generate the aggregation', () => {
+    expect(getExecutionSummaryAggregation()).toMatchSnapshot();
+  });
+});
+
+describe('formatExecutionSummary', () => {
+  it('should format the latest execution summary correctly', () => {
+    const results = {
+      aggregations: {
+        executionsCount: { doc_count: 18 },
+        latestExecutionOutcome: {
+          doc_count: 18,
+          by_rule_id: {
+            buckets: [
+              {
+                key: '89b2e1a0-1282-4601-97e4-2a3b1a2ef43b',
+                doc_count: 12,
+                latest_execution: {
+                  hits: {
+                    total: { value: 12, relation: 'eq' },
+                    hits: [
+                      {
+                        _source: { event: { outcome: 'success' } },
+                        sort: [1742893715888],
+                      },
+                    ],
+                  },
+                },
+              },
+              {
+                key: 'e1e5eddc-5251-4bb4-8aa4-a76943dd82e1',
+                doc_count: 6,
+                latest_execution: {
+                  hits: {
+                    total: { value: 6, relation: 'eq' },
+                    hits: [
+                      {
+                        _source: { event: { outcome: 'failure' } },
+                        sort: [1742893718878],
+                      },
+                    ],
+                  },
+                },
+              },
+            ],
+          },
+        },
+        successfulExecutionsCount: { doc_count: 17 },
+      },
+      hits: {
+        total: { value: 36, relation: 'eq' },
+        hits: [],
+      } as estypes.SearchHitsMetadata<unknown>,
+    };
+
+    expect(formatExecutionSummaryResult(results)).toEqual({
+      executions: { total: 18, success: 17 },
+      latestExecutionSummary: {
+        success: 1,
+        failure: 1,
+        warning: 0,
+      },
+    });
+  });
+});