第10章 メトリクス


API には、Automation Controller に関するリアルタイムのメトリクスを生成するメトリクスエンドポイント /api/controller/v2/metrics/ が用意されており、オープンソースプロジェクトの Prometheus などのシステム監視ソフトウェアで利用できます。

metrics/ エンドポイントに表示されるデータタイプは 、Content-type: text/plain および application/json です。

このエンドポイントからは、アクティブなユーザーセッションの数や、各 Automation Controller ノードでアクティブに実行されているジョブの数など、有用な情報が得られます。

Automation Controller メトリクスエンドポイントにアクセスし、このデータを時系列データベースに保存することで、Automation Controller からこれらのメトリクスを収集するように Prometheus を設定できます。

その後、クライアントは Prometheus を他のソフトウェア (Grafana や Metricbeat など) と組み合わせて使用して、データを視覚化したりアラートを設定したりできます。

10.1. Prometheus のセットアップ

Prometheus をセットアップして使用するには、仮想マシンまたはコンテナーに Prometheus をインストールする必要があります。

詳細は、First steps with Prometheus ドキュメントを参照してください。

手順

  1. Prometheus 設定ファイル (通常は prometheus.yml) で、<token_value>、作成した Automation Controller ユーザーの有効なユーザー名とパスワード、および <controller_host> を指定します。

    注記

    または、OAuth2 トークンを提供することもできます (これは /api/v2/users/N/personal_tokens/ で生成できます)。デフォルトでは、ユーザー名が admin、パスワードが password の ユーザーを想定した設定になっています。

    /api/v2/tokens エンドポイントで作成された OAuth2 トークンを使用して Prometheus を Automation Controller で認証する場合、次の例は、Automation Controller のメトリクスエンドポイントの URL が /https://controller_host:443/メトリクスで ある場合に有効なスクレイピング設定を提供します。

    scrape_configs
    
      - job_name: 'controller'
        tls_config:
            insecure_skip_verify: True
        metrics_path: /api/v2/metrics
        scrape_interval: 5s
        scheme: https
        bearer_token: <token_value>
        # basic_auth:
        #   username: admin
        #   password: password
        static_configs:
            - targets:
                - <controller_host>

    アラートやサービスディスカバリー設定など、Prometheus の他の要素を設定する方法は、Prometheus configuration ドキュメントを参照してください。

    Prometheus がすでに実行されている場合は、リロードエンドポイントに POST リクエスト を送信するか、Prometheus プロセスまたはサービスを強制終了することで、設定変更を適用するために Prometheus を再起動する必要があります。

  2. ブラウザーを使用して、Prometheus UI の /http://<your_prometheus>:9090/graph にアクセスし、いくつかのクエリーをテストしてください。たとえば、awx_sessions_total{type="user"} を実行することで、現在アクティブな Automation Controller ユーザーセッションの数を照会できます。

    Prometheus queries

次のステップ

クエリーのその他の方法については、インスタンスの Automation Controller API のメトリクスエンドポイント (api/v2/メトリクス) を参照してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Legal Notice

Theme

© 2026 Red Hat
トップに戻る