Home
Login
grafana/agentPlease refer to the latest official releases for information GitHub Homepage

OpenTelemetryベースのプログラマブルな可観測性データ収集エージェント。メトリクス、ログ、トレース、継続的パフォーマンス分析をサポート。

Apache-2.0Go 1.6kgrafanaagent Last Updated: 2025-06-24

Grafana Agent プロジェクト詳細

プロジェクト概要

Grafana Agent は、OpenTelemetry Collector をベースとしたディストリビューションであり、Terraform にインスパイアされた設定スタイルを採用しています。Prometheus や OpenTelemetry を含む、多様なエコシステムと互換性のある、柔軟で高性能な可観測性データ収集ツールとして設計されています。

⚠️ 重要なお知らせ： Grafana Agent は非推奨となり、現在は長期サポートモードに入っています。Grafana Agent Flow をベースに構築された新しいバージョンの Grafana Alloy への移行を推奨します。

主要な特徴

1. ベンダーニュートラル

  • 完全な互換性：Prometheus、OpenTelemetry、Grafana のオープンソースエコシステムと完全に互換性があります。
  • マルチシグナルサポート：メトリクス、ログ、トレース、継続的パフォーマンス分析データを収集します。
  • 柔軟なデプロイ：任意の数のマシンにデプロイでき、数百万のアクティブシーケンスと TB 級のログを処理します。

2. コンポーネント化されたアーキテクチャ

Grafana Agent はコンポーネントに基づいて構築されています。コンポーネントは接続され、テレメトリデータの収集、処理、および転送のためのプログラマブルな可観測性パイプラインを形成します。

3. データ収集と転送

Grafana Agent は、以下の場所にデータを収集、変換、および送信できます。

  • Prometheus エコシステム
  • OpenTelemetry エコシステム
  • Grafana オープンソースエコシステム（Loki、Grafana、Tempo、Mimir、Pyroscope を含む）

4. エンタープライズレベルの機能

  • スケーラビリティ：大規模なデプロイをサポートし、数百万のアクティブシーケンスを処理します。
  • 実戦検証済み：Prometheus および OpenTelemetry Collector プロジェクトの実戦検証済みのコードを拡張しています。
  • 強力な機能：プログラマブルなパイプラインの記述をサポートし、デバッグ用の組み込み UI を提供します。
  • すぐに使用可能：MySQL、Kubernetes、Apache などのシステムと統合されています。

技術アーキテクチャ

Flow モード

このページでは、主に "Flow モード" に焦点を当てます。これは、Grafana Agent の Terraform にインスパイアされた改訂版です。Flow モードは、より直感的な設定方法を提供し、ユーザーは次のことが可能になります。

  • 設定を簡単にセットアップおよび確認できます。
  • テレメトリパイプラインを迅速に反復処理できます。
  • 学習曲線を低減します。

設定例

// メトリクスを収集するために Kubernetes ポッドを検出する
discovery.kubernetes "pods" {
  role = "pod"
}

// Kubernetes ポッドからメトリクスを収集する
prometheus.scrape "default" {
  targets = discovery.kubernetes.pods.targets
  forward_to = [prometheus.remote_write.default.receiver]
}

// ディスクから API キーを取得する
local.file "apikey" {
  filename = "/var/data/my-api-key.txt"
  is_secret = true
}

// メトリクスを Prometheus remote_write エンドポイントに送信する
prometheus.remote_write "default" {
  endpoint {
    url = "http://localhost:9009/api/prom/push"
    basic_auth {
      username = "MY_USERNAME"
      password = local.file.apikey.content
    }
  }
}

プロジェクトの状態と移行

非推奨の説明

Grafana Alloy は、OTel Collector ディストリビューションの新しい名前です。Grafana Agent は非推奨となり、2025 年 10 月 31 日まで長期サポート (LTS) が提供されます。Grafana Agent は 2025 年 11 月 1 日にライフサイクル終了 (EOL) に達します。

移行の推奨事項

プロジェクトメンテナーは、次の理由から Grafana Alloy への移行を強く推奨します。

  • より優れたパフォーマンスと安定性
  • より豊富なエンタープライズレベルの機能
  • 継続的な機能更新とサポート

インストールとデプロイ

サポートプラットフォーム

  • Linux、macOS、Windows
  • Docker コンテナ
  • Kubernetes クラスタ
  • クラウドプラットフォーム（AWS、GCP、Azure など）

クイックスタート

プロジェクトは完全なドキュメントとサンプルを提供します。

  • 詳細なインストールガイド
  • 入門チュートリアル
  • コンポーネントリファレンスドキュメント
  • Docker Compose サンプル環境

典型的な使用シナリオ

1. 大規模モニタリング

数百万のアクティブシーケンスを処理する必要がある大規模な Prometheus デプロイに適しています。

2. マルチシグナル収集

メトリクス、ログ、トレース、およびパフォーマンス分析データを統一的に収集します。

3. ハイブリッドクラウド環境

マルチクラウドおよびハイブリッドクラウド環境で一貫した可観測性ソリューションを提供します。

4. DevOps 統合

CI/CD パイプラインおよび GitOps ワークフローと深く統合します。

まとめ

Grafana Agent は、成熟した可観測性データ収集ツールとして、ユーザーに強力なテレメトリデータの収集、処理、および転送機能を提供します。プロジェクトはメンテナンスモードに入っていますが、そのコアとなる理念とアーキテクチャは、次世代の Grafana Alloy の強固な基盤を築きました。既存のユーザーは、より優れたパフォーマンスと継続的なサポートを得るために、公式ガイドに従って Grafana Alloy に段階的に移行することを推奨します。

Star History Chart