{"id":13432525,"url":"https://github.com/grafana/agent","last_synced_at":"2025-05-14T08:05:11.036Z","repository":{"id":37419366,"uuid":"224021526","full_name":"grafana/agent","owner":"grafana","description":"Vendor-neutral programmable observability pipelines.","archived":false,"fork":false,"pushed_at":"2025-04-29T13:28:18.000Z","size":100656,"stargazers_count":1620,"open_issues_count":106,"forks_count":489,"subscribers_count":156,"default_branch":"main","last_synced_at":"2025-05-07T07:08:47.097Z","etag":null,"topics":["agent","grafana","loki","monitoring","observability","opentelemetry","opentelemetry-collector","prometheus"],"latest_commit_sha":null,"homepage":"https://grafana.com/docs/agent/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grafana.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-25T19:06:47.000Z","updated_at":"2025-04-29T13:28:20.000Z","dependencies_parsed_at":"2023-10-16T18:50:06.345Z","dependency_job_id":"49a76680-7988-458c-9563-9bc21de41c99","html_url":"https://github.com/grafana/agent","commit_stats":{"total_commits":3131,"total_committers":315,"mean_commits":9.93968253968254,"dds":0.8163526030022357,"last_synced_commit":"639d575f8ca732a038ab44e6ff0087a560a4a8b9"},"previous_names":[],"tags_count":239,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Fagent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Fagent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Fagent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grafana%2Fagent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grafana","download_url":"https://codeload.github.com/grafana/agent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101586,"owners_count":22014907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","grafana","loki","monitoring","observability","opentelemetry","opentelemetry-collector","prometheus"],"created_at":"2024-07-31T02:01:12.854Z","updated_at":"2025-05-14T08:05:06.027Z","avatar_url":"https://github.com/grafana.png","language":"Go","funding_links":[],"categories":["Go","monitoring","Agent Integration \u0026 Deployment Tools"],"sub_categories":["AI Agent Operating System"],"readme":"\u003e **Deprecation notice**: Grafana Agent has been deprecated and is now in\n\u003e Long-Term Support mode. We recommend migrating to the new [Grafana Alloy]\n\u003e collector, which is built on the foundation of Grafana Agent Flow.\n\u003e\n\u003e For more information, read our blog posts about Alloy and how to easily\n\u003e migrate from Agent to Alloy:\n\u003e\n\u003e * [Alloy announcement blog post](https://grafana.com/blog/2024/04/09/grafana-alloy-opentelemetry-collector-with-prometheus-pipelines/)\n\u003e * [Alloy FAQ](https://grafana.com/blog/2024/04/09/grafana-agent-to-grafana-alloy-opentelemetry-collector-faq/)\n\u003e * [Migrate to Alloy](https://grafana.com/docs/alloy/latest/tasks/migrate/)\n\u003e\n\u003e [Grafana Alloy]: https://github.com/grafana/alloy\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"docs/sources/assets/logo_and_name.png\" alt=\"Grafana Agent logo\"\u003e\u003c/p\u003e\n\nGrafana Agent is an OpenTelemetry Collector distribution with configuration\ninspired by [Terraform][]. It is designed to be flexible, performant, and\ncompatible with multiple ecosystems such as Prometheus and OpenTelemetry.\n\nGrafana Agent is based around **components**. Components are wired together to\nform programmable observability **pipelines** for telemetry collection,\nprocessing, and delivery.\n\n\u003e **NOTE**: This page focuses mainly on \"[Flow mode][Grafana Agent Flow],\" the\n\u003e Terraform-inspired revision of Grafana Agent.\n\nGrafana Agent can collect, transform, and send data to:\n\n* The [Prometheus][] ecosystem\n* The [OpenTelemetry][] ecosystem\n* The Grafana open source ecosystem ([Loki][], [Grafana][], [Tempo][], [Mimir][], [Pyroscope][])\n\n[Terraform]: https://terraform.io\n[Grafana Agent Flow]: https://grafana.com/docs/agent/latest/flow/\n[Prometheus]: https://prometheus.io\n[OpenTelemetry]: https://opentelemetry.io\n[Loki]: https://github.com/grafana/loki\n[Grafana]: https://github.com/grafana/grafana\n[Tempo]: https://github.com/grafana/tempo\n[Mimir]: https://github.com/grafana/mimir\n[Pyroscope]: https://github.com/grafana/pyroscope\n\n## Why use Grafana Agent?\n\n* **Vendor-neutral**: Fully compatible with the Prometheus, OpenTelemetry, and\n  Grafana open source ecosystems.\n* **Every signal**: Collect telemetry data for metrics, logs, traces, and\n  continuous profiles.\n* **Scalable**: Deploy on any number of machines to collect millions of active\n  series and terabytes of logs.\n* **Battle-tested**: Grafana Agent extends the existing battle-tested code from\n  the Prometheus and OpenTelemetry Collector projects.\n* **Powerful**: Write programmable pipelines with ease, and debug them using a\n  [built-in UI][UI].\n* **Batteries included**: Integrate with systems like MySQL, Kubernetes, and\n  Apache to get telemetry that's immediately useful.\n\n[UI]: https://grafana.com/docs/agent/latest/flow/monitoring/debugging/#grafana-agent-flow-ui\n\n## Getting started\n\nCheck out our [documentation][] to see:\n\n* [Installation instructions][] for Grafana Agent Flow\n* Details about [Grafana Agent Flow][]\n* Steps for [Getting started][] with Grafana Agent Flow\n* The list of Grafana Agent Flow [Components][]\n\n[documentation]: https://grafana.com/docs/agent/latest/\n[Installation instructions]: https://grafana.com/docs/agent/latest/flow/setup/install/\n[Grafana Agent Flow]: https://grafana.com/docs/agent/latest/flow/\n[Getting started]: https://grafana.com/docs/agent/latest/flow/getting_started/\n[Components]: https://grafana.com/docs/agent/latest/flow/reference/components/\n\n## Example\n\n```river\n// Discover Kubernetes pods to collect metrics from.\ndiscovery.kubernetes \"pods\" {\n  role = \"pod\"\n}\n\n// Collect metrics from Kubernetes pods.\nprometheus.scrape \"default\" {\n  targets    = discovery.kubernetes.pods.targets\n  forward_to = [prometheus.remote_write.default.receiver]\n}\n\n// Get an API key from disk.\nlocal.file \"apikey\" {\n  filename  = \"/var/data/my-api-key.txt\"\n  is_secret = true\n}\n\n// Send metrics to a Prometheus remote_write endpoint.\nprometheus.remote_write \"default\" {\n  endpoint {\n    url = \"http://localhost:9009/api/prom/push\"\n\n    basic_auth {\n      username = \"MY_USERNAME\"\n      password = local.file.apikey.content\n    }\n  }\n}\n```\n\nWe maintain an example [Docker Compose environment][] that can be used to\nlaunch dependencies to play with Grafana Agent locally.\n\n[Docker Compose environment]: ./example/docker-compose/\n\n## Release cadence\n\nA new minor release is planned every six weeks.\n\nThe release cadence is best-effort: if necessary, releases may be performed\noutside of this cadence, or a scheduled release date can be moved forwards or\nbackwards.\n\nMinor releases published on cadence include updating dependencies for upstream\nOpenTelemetry Collector code if new versions are available. Minor releases\npublished outside of the release cadence may not include these dependency\nupdates.\n\nPatch and security releases may be created at any time.\n\n## Community\n\nTo engage with the Grafana Agent community:\n\n* Chat with us on our community Slack channel. To invite yourself to the\n  Grafana Slack, visit \u003chttps://slack.grafana.com/\u003e and join the `#agent`\n  channel.\n* Ask questions on the [Discussions page][].\n* [File an issue][] for bugs, issues, and feature suggestions.\n* Attend the monthly [community call][].\n\n[Discussions page]: https://github.com/grafana/agent/discussions\n[File an issue]: https://github.com/grafana/agent/issues/new\n[community call]: https://docs.google.com/document/d/1TqaZD1JPfNadZ4V81OCBPCG_TksDYGlNlGdMnTWUSpo\n\n## Contribute\n\nRefer to our [contributors guide][] to learn how to contribute.\n\n[contributors guide]: ./docs/developer/contributing.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrafana%2Fagent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrafana%2Fagent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrafana%2Fagent/lists"}