本文へスキップ

OpenMetricsエージェントのインストール

OpenAgentは、Prometheusエンドポイントからメトリクスを収集してWhaTapサーバーに送信するエージェントです。SingleStoreプロジェクトでOpenMetricsエクスプローラーとテンプレートを使用するには、まずOpenAgentをインストールする必要があります。

OpenAgentの動作には、次の3つのファイルが同じディレクトリに必要です。

FileDescription
openagentメトリクスの収集・送信を行う実行ファイル
whatap.confライセンス・収集サーバーアドレスなどの基本設定
scrape_config.yamlスクレイピング対象(エンドポイント)の定義

インストール手順の概要

  1. インストールディレクトリを作成後、アーキテクチャに合ったバイナリをダウンロードします(AMD64/ARM64)。

    mkdir -p /opt/whatap/openagent
    cd /opt/whatap/openagent
    wget https://repo.whatap.io/openagent/latest/amd/openagent
    chmod +x openagent
  2. whatap.conf にライセンス・サーバーアドレス・ポートを入力します。

    echo "WHATAP_LICENSE=your-whatap-license" >> whatap.conf
    echo "WHATAP_HOST=your-whatap-host" >> whatap.conf
    echo "WHATAP_PORT=your-whatap-port" >> whatap.conf
  3. scrape_config.yaml に収集対象エンドポイントを定義します(修正時は自動的に再読み込みされ、再起動は不要です)。

  4. standaloneモードで実行します。

    ./openagent standalone
ノート

インストール手順全体・実行モード・scrape_config.yaml の詳細オプション(StaticEndpoints・params・metricRelabelConfigs)と設定項目については、OpenAgentのインストール および OpenAgentの設定 ドキュメントを参照してください。Kubernetes環境については OpenAgent Kubernetes構成 に従います。

ノート

macOS Apple Siliconはサポートされていません。Linux AMD64またはARM64でのみ動作します。