Caution
Grafana Alloy is the new name for our distribution of the OTel collector. Grafana Agent has been deprecated and is in Long-Term Support (LTS) through October 31, 2025. Grafana Agent will reach an End-of-Life (EOL) on November 1, 2025. Read more about why we recommend migrating to Grafana Alloy.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Dynamic Configuration Cookbook
The purpose of this cookbook is to guide you through common scenarios of using dynamic configuration. Each section contains increasingly more complex use cases, but feel free to jump in wherever you feel appropriate.
Basics
The basic section covers
- The Structure of how agent and server templates are loaded
- How metrics Instances are loaded
- How Integrations are loaded
- How Logs and Traces are loaded
Templates
The Templates section includes
- Looping with basic command usage and simple loops
- Datasource covers usage of external datastores you can use to pull in data as new data sources.
- Datasources and Objects covers the usage of complex json objects
Advanced
The Advanced section includes
- The AWS example queries EC2 for instances.