AWS Key Management Service (KMS)

Overview

AWS Key Management Service (KMS) is a managed service that makes it easy for you to create and control the encryption keys used to encrypt your data.

Enable this integration to see in Datadog all your KMS metrics.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that KMS is enabled under the Metric Collection tab.

  2. Install the Datadog - AWS Key Management Service (KMS) integration.

Log collection

Enable logging

Configure AWS KMS to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_kms is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your AWS KMS logs in the AWS console:

Data Collected

Metrics

aws.kms.cloud_hsm_key_store_throttle
(count)		The number of requests for cryptographic operations on KMS keys in AWS CloudHSM key store that AWS KMS throttles.
Shown as request
aws.kms.external_key_store_throttle
(count)		The number of requests for cryptographic operations on KMS keys in external key store that AWS KMS throttles.
Shown as request
aws.kms.seconds_until_key_material_expiration
(gauge)		The number of seconds remaining until the earliest-expiring imported key material in a KMS key expires.
Shown as second
aws.kms.successful_request
(count)		The number of successful requests for cryptographic operations on a specific KMS key.
Shown as request
aws.kms.xks_external_key_manager_states
(count)		The count of external key manager instances in various health states for external key stores.
Shown as instance
aws.kms.xks_proxy_certificate_days_to_expire
(gauge)		The number of days until the TLS certificate for the external key store proxy endpoint expires.
Shown as day
aws.kms.xks_proxy_credential_age
(gauge)		The number of days since the current external key store proxy authentication credential was associated with the external key store.
Shown as day
aws.kms.xks_proxy_errors
(count)		The number of exceptions related to AWS KMS requests to the external key store proxy.
Shown as error
aws.kms.xks_proxy_latency
(gauge)		The number of milliseconds it takes for an external key store proxy to respond to an AWS KMS request.
Shown as millisecond

Each of the metrics retrieved from AWS are assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

Events

The AWS KMS integration does not include any events.

Service Checks

The AWS KMS integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.