elastic · lucian-ioan · Jun 5, 2023 · May 12, 2023 · May 14, 2023 · May 14, 2023
@@ -1,4 +1,9 @@
 # newer versions go on top
+- version: "1.35.0"
+  changes:
+    - description: Add AWS API Gateway data stream.
+      type: enhancement
+      link: https://github.com/elastic/integrations/pull/6188
 - version: "1.34.5"
   changes:
     - description: Migrate AWS Lambda metrics dashboard visualizations to lenses.

@@ -0,0 +1,63 @@
+metricsets: ["cloudwatch"]
+period: {{period}}
+{{#if data_granularity}}
+data_granularity: {{data_granularity}}
+{{/if}}
+{{#if access_key_id}}
+access_key_id: {{access_key_id}}
+{{/if}}
+{{#if secret_access_key}}
+secret_access_key: {{secret_access_key}}
+{{/if}}
+{{#if session_token}}
+session_token: {{session_token}}
+{{/if}}
+{{#if credential_profile_name}}
+credential_profile_name: {{credential_profile_name}}
+{{/if}}
+{{#if shared_credential_file}}
+shared_credential_file: {{shared_credential_file}}
+{{/if}}
+{{#if role_arn}}
+role_arn: {{role_arn}}
+{{/if}}
+{{#if default_region}}
+default_region: {{default_region}}
+{{/if}}
+{{#if regions}}
+regions:
+{{#each regions as |region i|}}
+- {{region}}
+{{/each}}
+{{/if}}
+{{#if latency}}
+latency: {{latency}}
+{{/if}}
+{{#if tags_filter}}
+tags_filter: {{tags_filter}}
+{{/if}}
+{{#if proxy_url }}
+proxy_url: {{proxy_url}}
+{{/if}}
+metrics:
+- namespace: AWS/ApiGateway
+  statistic: ["Sum"]
+  name:
+  - 4XXError
+  - 4xx
+  - 5XXError
+  - 5xx
+  - CacheHitCount
+  - CacheMissCount
+  - Count
+  - ConnectCount
+  - MessageCount
+  - IntegrationError
+  - ClientError
+  - ExecutionError
+- namespace: AWS/ApiGateway
+  statistic: ["Average"]
+  name:
+  - Latency  
+  - IntegrationLatency
+  - DataProcessed
@@ -0,0 +1,35 @@
+- name: cloud
+  title: Cloud
+  group: 2
+  description: Fields related to the cloud or infrastructure the events are coming from.
+  footnote: 'Examples: If Metricbeat is running on an EC2 host and fetches data from its host, the cloud info contains the data about this machine. If Metricbeat runs on a remote machine outside the cloud and fetches data from a service running in the cloud, the field contains cloud data from the machine the service is running on.'
+  type: group
+  fields:
+    - name: image.id
+      type: keyword
+      description: Image ID for the cloud instance.
+- name: host
+  title: Host
+  group: 2
+  description: 'A host is defined as a general computing instance.
+
+    ECS host.* fields should be populated with details about the host on which the event happened, or from which the measurement was taken. Host types include hardware, virtual machines, Docker containers, and Kubernetes nodes.'
+  type: group
+  fields:
+    - name: containerized
+      type: boolean
+      description: >
+        If the host is a container.
+
+    - name: os.build
+      type: keyword
+      example: "18D109"
+      description: >
+        OS build information.
+
+    - name: os.codename
+      type: keyword
+      example: "stretch"
+      description: >
+        OS codename, if any.
+
@@ -0,0 +1,20 @@
+- name: data_stream.type
+  type: constant_keyword
+  description: Data stream type.
+- name: data_stream.dataset
+  type: constant_keyword
+  description: Data stream dataset.
+- name: data_stream.namespace
+  type: constant_keyword
+  description: Data stream namespace.
+- name: '@timestamp'
+  type: date
+  description: Event timestamp.
+- name: event.module
+  type: constant_keyword
+  description: Event module
+  value: aws
+- name: event.dataset
+  type: constant_keyword
+  description: Event dataset
+  value: aws.apigateway_metrics
@@ -0,0 +1,62 @@
+- external: ecs
+  name: cloud
+- external: ecs
+  name: cloud.account.id
+- external: ecs
+  name: cloud.account.name
+- external: ecs
+  name: cloud.availability_zone
+- external: ecs
+  name: cloud.instance.id
+- external: ecs
+  name: cloud.machine.type
+- external: ecs
+  name: cloud.provider
+- external: ecs
+  name: cloud.region
+- external: ecs
+  name: ecs.version
+- external: ecs
+  name: error
+- external: ecs
+  name: error.message
+- external: ecs
+  name: service.type
+- external: ecs
+  name: host.architecture
+- external: ecs
+  name: host.domain
+- external: ecs
+  name: host.hostname
+- external: ecs
+  name: host.id
+- external: ecs
+  name: host.ip
+- external: ecs
+  name: host.mac
+- external: ecs
+  name: host.name
+- external: ecs
+  name: host.os.family
+- external: ecs
+  name: host.os.kernel
+- external: ecs
+  name: host.os.name
+- external: ecs
+  name: host.os.platform
+- external: ecs
+  name: host.os.version
+- external: ecs
+  name: host.type
+- external: ecs
+  name: cloud.instance.name
+- external: ecs
+  name: cloud.project.id
+- external: ecs
+  name: container.id
+- external: ecs
+  name: container.image.name
+- external: ecs
+  name: container.labels
+- external: ecs
+  name: container.name
@@ -0,0 +1,84 @@
+- name: aws
+  type: group
+  fields:
+    - name: apigateway
+      type: group
+      fields:
+        - name: metrics
+          type: group
+          fields:
+            - name: 4XXError.sum
+              type: long
+              description: The number of client-side errors captured in a given period.
+            - name: 4xx.sum
+              type: long
+              description: The number of client-side errors captured in a given period.
+            - name: 5XXError.sum
+              type: long
+              description: The number of server-side errors captured in a given period.
+            - name: 5xx.sum
+              type: long
+              description: The number of server-side errors captured in a given period.
+            - name: Count.sum
+              type: long
+              description: The total number API requests in a given period.
+            - name: IntegrationLatency.avg
+              type: long
+              description: The time between when API Gateway relays a request to the backend and when it receives a response from the backend.
+            - name: Latency.avg
+              type: long
+              description: The time between when API Gateway receives a request from a client and when it returns a response to the client.
+            - name: DataProcessed.avg
+              type: long
+              description: The amount of data processed in bytes.
+            - name: CacheHitCount.sum
+              type: long
+              description: The number of requests served from the API cache in a given period.
+            - name: CacheMissCount.sum
+              type: long
+              description: The number of requests served from the backend in a given period, when API caching is enabled.
+            - name: Count.sum
+              type: long
+              description: The total number API requests in a given period.
+            - name: ConnectCount.sum
+              type: long
+              description: The number of messages sent to the connect route integration.
+            - name: MessageCount.sum
+              type: long
+              description: The number of messages sent to the WebSocket API, either from or to the client.
+            - name: IntegrationError.sum
+              type: long
+              description: The number of requests that return a 4XX/5XX response from the integration.
+            - name: ClientError.sum
+              type: long
+              description: The number of requests that have a 4XX response returned by API Gateway before the integration is invoked.
+            - name: ExecutionError.sum
+              type: long
+              description: Errors that occurred when calling the integration.
+    - name: dimensions
+      type: group
+      fields:
+        - name: ApiId
+          type: keyword
+          description: Each API created in API Gateway is assigned a unique ApiId, which is used to distinguish and reference that specific API within the system.
+        - name: Stage
+          type: keyword
+          description: It represents a specific version of the API that is accessible to clients. A stage allows you to manage different environments or versions of your API, such as development, testing, and production.
+        - name: Route
+          type: keyword
+          description: Routes define the path and HTTP methods that clients can use to access different functionalities of the API.
+        - name: ApiName
+          type: keyword
+          description: It represents a human-readable name that helps identify and differentiate the API within the API Gateway service.
+        - name: Method
+          type: keyword
+          description: It represents the HTTP method which defines the action that can be performed on a resource, such as retrieving, creating, updating, or deleting data.
+        - name: Resource
+          type: keyword
+          description: It represents an endpoint within the API that corresponds to a specific functionality, typically associated with a URL path segment.
+    - name: cloudwatch
+      type: group
+      fields:
+        - name: namespace
+          type: keyword
+          description: The namespace specified when query cloudwatch api.
@@ -0,0 +1,15 @@
+- name: aws
+  type: group
+  fields:
+    - name: tags.*
+      type: object
+      description: |
+        Tag key value pairs from aws resources.
+    - name: s3.bucket.name
+      type: keyword
+      description: |
+        Name of a S3 bucket.
+    - name: dimensions.*
+      type: object
+      description: |
+        Metric dimensions.
@@ -0,0 +1,32 @@
+title: AWS API Gateway metrics
+type: metrics
+streams:
+  - input: aws/metrics
+    vars:
+      - name: period
+        type: text
+        title: Collection Period
+        multi: false
+        required: true
+        show_user: true
+        default: 5m
+      - name: data_granularity
+        type: text
+        title: Data Granularity
+        multi: false
+        required: false
+        show_user: false
+      - name: regions
+        type: text
+        title: Regions
+        multi: true
+        required: false
+        show_user: true
+      - name: latency
+        type: text
+        title: Latency
+        multi: false
+        required: false
+        show_user: false
+    title: AWS API Gateway metrics
+    description: Collect AWS API Gateway metrics