Ingest CloudWatch Metrics
Last updated
Last updated
groundcover supports ingesting CloudWatch metrics directly into our platform, allowing you to visualize them using dashboards and create alerts.
CloudWatch integration is done by deploying a service called integrations-agent
which is responsible for pulling metrics from CloudWatch using periodic polling of these APIs:
The integration is setup using the following steps:
Create a role with permissions to access the metrics on the target AWS account
Provide the needed permissions to allow the integrations-agent
service account to assume the new role
Select the AWS namespaces you wish to collect metrics from
Deploy the integrations-agent
service and start collecting metrics
The integration pulls data from CloudWatch every five minutes.
Data fetched is stored in the Victoria Metrics database, meaning metrics are queried via the CloudWatch API only one time per data point.
Each metric has a label called stat
which denotes the used during querying. Some metrics have multiple stats which are useful for different cases.
YOUR_GROUNDCOVER_ACCOUNT_ID
- the AWS account id hosting the groundcover backend,
Fetch your inCloud Site
from
It will look like <SITE_ID>.platform.grcv.io
Go to
Select the AWS namespaces you wish to ingest metrics from. The list of supported services is .
In this setup, the integrations-agent
is deployed inside your cluster. The deployment comes with a built-in service account, and permissions will be provided to it using . Afterwards you will need to create a role + trust policy to allow the integrations-agent
service account to assume the role and query the metrics.
The recommended way to give the integrations-agent
the ability to interact with AWS resources inside an EKS cluster is using . The deployment comes in with a built-in service account, which can be used alongside OIDC to provide it with AWS permissions.
Go to
Select the AWS namespaces you wish to ingest metrics from. The list of supported services is . These will be provided as a list in the next stage.