Amazon Managed Service for Prometheus

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 the Dynatrace menu, go to Hub.
Find and 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
```
shell
.\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 and then Add ActiveGate extension.
Select Upload extension and upload the ZIP file.
After you upload the extension, go to Settings > Monitoring > Monitored technologies and switch to the Custom extensions tab.
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: plaintext `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 the 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.