Amazon Managed Service for Prometheus

Deprecation notice

This extension documentation is now deprecated and will no longer be updated. We recommend using the new Amazon Managed Service for Prometheus extension for improved functionality and support.

Early Adopter

Learn how to extract metrics from Amazon Managed Service for Prometheus (AMP) using the AMP ActiveGate extension.

Prerequisites

Environment ActiveGate with access to the AMP Endpoint - query URL
A Dynatrace API token with the permissions Ingest metrics and Write settings
An AWS Access key + Secret access key with permissions for the actions aps:QueryMetrics, aps:DescribeWorkspace and aps:GetMetricMetadata

Extension installation

To install the AMP extension

In Dynatrace Hub, select Amazon Managed Service for Prometheus.
Select Download to get the extension ZIP file. Don't rename the file.
Unzip the ZIP file to the plugin_deployment directory of your ActiveGate host. If the resulting directory structure isn't
```
.\plugin_deployment\<EXTENSION-SPECIFIC-DIRECTORY>\
```
where <EXTENSION-SPECIFIC-DIRECTORY> is the name of the directory containing the files for this extension, make the necessary changes.
In Dynatrace, go to Settings > Monitoring > Monitored technologies.
Select Add new technology monitoring > Add ActiveGate extension.
Select Upload extension and upload the ZIP file.
After you upload the extension, go to Settings > Monitoring > Monitored technologies > Custom extensions.
Find the extension and select it to open it for Endpoint configuration.
Enter the endpoint information.

Setting

Details

Endpoint name

Enter a meaningful endpoint name.

Dynatrace Tenant URL

Complete URL of the environment/tenant.

Managed: https://{your-domain}/e/{your-environment-id}
SaaS: https://{your-environment-id}.live.dynatrace.com

Dynatrace API Token

Access token used to authenticate the calls to the Dynatrace environment. Required API v2 permissions: Ingest metrics and Write settings.

AWS Access Key

Permission for the following actions: aps:QueryMetrics, aps:DescribeWorkspace and aps:GetMetricMetadata.

AWS Secret Access Key

The secret access key that corresponds with the access key.

AWS Region

The AWS region where the AMP is located. For example: us-east-1.

AWS Managed Prometheus Workspace ID

The AMP workspace ID. This can be found on the workspace detail page.

Metrics to ingest

To ingest several metrics, enter one metric per line. PromQL can be used for complex queries. Start a line with [metric name]# to provide a metric name if one cannot be allocated automatically, such as with complex queries. Example input:

up
go_memstats_lookups_total{job="prometheus"}
shifted_localhost_memstat_lookups#sum(go_memstats_lookups_total{instance="localhost:8000"} offset 5m)
process_virtual_memory_max_bytes

Metrics

The extension sends the AMP metrics through the Dynatrace Metrics API v2 ingest channel. Use Data Explorer to access the collected metrics. The metrics start with the aws.prometheus string.

Collected metrics consume Davis Data Units. For more information, see DDUs for custom metrics.