Application Real-Time Monitoring Service (ARMS) は、アプリケーション監視データを Managed Service for Prometheus に保存します。Managed Service for Prometheus は、オープンソースの Grafana および PromQL と完全互換です。これにより、ARMS のアプリケーションメトリクスと任意の Prometheus 互換ソースからのデータを組み合わせたカスタム Grafana ダッシュボードを作成でき、アプリケーションの健全性、インフラストラクチャ、ビジネスメトリクスを統合的に確認できます。
ユースケース
アプリケーションメトリクスと他のデータソースからのインフラストラクチャまたはビジネスメトリクスを統合した運用ダッシュボードの構築
ピーク時間帯のダッシュボードを作成し、アプリケーションパフォーマンスと上流・下流サービスのメトリクスを相関付ける
既存のダッシュボードとともに、自己管理型 Grafana インスタンスで ARMS アプリケーション監視データを表示
Prometheus HTTP API を介して ARMS メトリクスをプログラムでクエリし、カスタムレポートや自動化に活用
ビジネス要件に基づき、ARMS アプリケーション監視データを二次開発に利用
仕組み
アプリケーションに対してアプリケーション監視を有効にすると、ARMS は同一リージョンに無料の Prometheus インスタンスを自動的に作成します。たとえば、中国 (杭州) リージョンで監視されているアプリケーションのメトリクスは、arms_metrics_cn-hangzhou_cloud_hangzhou という名前の Prometheus インスタンスに保存されます。
これらのメトリクスを Grafana で可視化するには、Prometheus インスタンスをデータソースとして追加し、PromQL または Grafana クエリビルダーを使用してメトリクスをクエリするパネルを作成します。
前提条件
作業を開始する前に、以下の条件を満たしていることを確認してください。
ご利用のアプリケーションに ARMS エージェントがインストールされていること。詳細については、「アプリケーション監視の概要」をご参照ください。
以下のいずれかの Grafana 環境を利用可能であること：
自己管理型 Grafana インストール（ローカルまたはサーバー上）
Managed Service for Grafana ワークスペース
ステップ 1：Grafana に ARMS をデータソースとして追加
Managed Service for Prometheus は、デフォルトでアプリケーション監視と統合されています。Grafana でデータを可視化するには、ご利用のアプリケーションメトリクスを保存している Prometheus インスタンスをデータソースとして追加します。
Grafana 環境に応じて、以下のいずれかの手順を選択してください。
自己管理型 Grafana へのデータソースの追加
Prometheus HTTP API URL の取得
ARMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択します。上部のナビゲーションバーで、ご利用のアプリケーションがデプロイされているリージョンを選択します。Prometheus Instance for Application Monitoring タイプのインスタンスは、そのリージョン内のアプリケーションの監視データを保存します。
インスタンス名をクリックし、左側のナビゲーションウィンドウで 設定項目 をクリックして HTTP API URL を確認します。
（オプション）トークンの生成 をクリックして、Prometheus インスタンスの認証トークンを作成します。このトークンは、Grafana がこのインスタンスからデータを読み取る際のアクセスを保護します。
重要トークンを生成した後は、このデータソースを追加する際にカスタム HTTP ヘッダーとして含める必要があります。そうしないと、Grafana はこのインスタンスからデータを読み取れません。
Grafana でのデータソースの設定
この例では Grafana 10.x を使用しています。他のバージョンについては、Grafana ドキュメントをご参照ください。
管理者として Grafana にログインします。
左上隅の
アイコンにカーソルを合わせ、データソース をクリックします。データソースの追加 をクリックし、Prometheus を選択します。
設定項目 タブで、以下のフィールドを設定します。
フィールド 値 Name このデータソースを識別するための説明的な名前 Prometheus server URL（HTTP セクション内） 前のステップで取得した HTTP API URL 
（オプション）認証トークンを生成した場合は、カスタムヘッダーとして追加します。カスタム HTTP ヘッダー セクションで、+ Add header をクリックします。Header に
Authorization、Value にトークンを設定します。
Save & test をクリックして接続を検証します。
Managed Service for Grafana へのデータソースの追加
Managed Service for Grafana では、ARMS アプリケーション監視データをワンクリックで統合できます。
ARMS コンソールにログインします。左側のナビゲーションウィンドウで、 を選択し、ワークスペース ID をクリックします。
ワークスペース情報 ページの クラウドサービス統合 セクションで、ARMS アプリケーション監視 をクリックします。対象リージョンの Prometheus インスタンスを見つけ、操作 列の 統合 をクリックします。
確認ダイアログボックスで、OK をクリックします。
統合が完了したら、操作 列の フォルダー をクリックします。
ダッシュボード タブで、ダッシュボード名をクリックして、事前設定済みのアプリケーション監視ダッシュボードを表示します。
データソースを確認するには、左上隅の
アイコンにカーソルを合わせ、データソース をクリックします。
ステップ 2：カスタムダッシュボードの作成
左上隅の
アイコンにカーソルを合わせ、ダッシュボード をクリックします。New Dashboard をクリックし、空のパネルを追加 をクリックします。
データソースの選択 ダイアログボックスで、データソースを選択します。デフォルトの命名形式は arms_metrics_{regionid}_cloud です。
重要先に進む前に、データソースにデータが含まれていることを確認してください。データが表示されない場合は、ご利用のアプリケーションがアクティブにメトリクスを報告していることを確認してください。
以下のいずれかの方法でクエリを設定します。
PromQL クエリの記述（コードモード）
コード モードに切り替え、メトリクスブラウザ の横に PromQL 式を入力します。
ヒント：特定のメトリクスの PromQL 式を確認するには、アプリケーション監視モジュールのアプリケーション詳細ページで、メトリクス横の
アイコンをクリックします。詳細については、「アプリケーション概要」をご参照ください。
PromQL 構文のリファレンスについては、Prometheus ドキュメントをご参照ください。
メトリクスを視覚的に選択（ビルダーモード）
ビルダー モードで、メトリック ドロップダウンリストからメトリクスを選択します。たとえば、JVM スレッド数をクエリするには、
arms_jvm_threads_countを選択します。ラベルフィルター セクションを使用して、ラベルと値を指定して結果を絞り込みます。
利用可能なメトリクスの完全な一覧については、「アプリケーション監視メトリクス」をご参照ください。
[Panel] タブ（右側）で、パネルのタイトルを設定し、チャートの種類を選択します。
説明同じメトリクスでも、異なるチャートタイプを使用することで、異なる粒度でデータを把握できます。
右上隅の Apply をクリックして、パネルをダッシュボードに保存します。
Prometheus HTTP API を介したメトリクスのクエリ
Grafana ダッシュボードに加えて、ARMS メトリクスは Prometheus HTTP API を介してもアクセス可能です。これにより、自動レポート、カスタムアラート機能、および独自ツールとの統合が可能になります。
クエリ URL の構築
以下の形式で、Prometheus HTTP API URL（ステップ 1 で取得）と PromQL 式を組み合わせてクエリ URL を作成します。
<Prometheus-HTTP-API-URL>/api/v1/query_range?query=<PromQL>&start=<startTime>&end=<endTime>&step=<step>クエリパラメーター
| パラメーター | 説明 | 例 |
|---|---|---|
query | PromQL 式 | arms_jvm_threads_count{pid="xxx"} |
start | 開始時刻（UNIX タイムスタンプ、秒単位） | 1728719399 |
end | 終了時刻（UNIX タイムスタンプ、秒単位） | 1728722999 |
step | クエリ解決ステップ | 60s |
認証
Prometheus インスタンスでトークンベースの認証が有効になっている場合、HTTP リクエストの Authorization ヘッダーに認証トークンを含めてください。シェルスクリプト、Python、Java、または任意の HTTP クライアントを使用して、これらのクエリを実行できます。
例
以下の URL は、呼び出しタイプごとにグループ化されたアプリケーションのリクエスト総数をクエリします。
https://cn-hangzhou.arms.aliyuncs.com:9443/api/v1/prometheus/7a8f8e783c66a44a0f6a1dc9a0b8f1/1277589232893727/arms-metrics-99214ff7de7d0b2d/cn-hangzhou/api/v1/query_range?query=sum by (callType,)(sum_over_time_lorc(arms_app_requests_count_ign_destid_endpoint_ppid_prpc{pid="ckv8e2vzfj@7e393063f3fd6ad",serverIp=~".*",callKind=~"http|rpc|custom_entry|server|consumer|schedule",source="apm", }[1m]))&start=1728719399&end=1728722999&step=60sこのクエリは、以下のようなデータを返します。
よくある質問
データのクエリに料金はかかりますか？
いいえ。データクエリは無料です。
PromQL クエリにレート制限はありますか？
スロットリング保護はありますが、秒間クエリ数 (QPS) を直接制限するものではありません。タイムアウトを回避するには、クエリレートを 50 QPS 未満に保ち、すべての操作をクエリするような高負荷クエリや、30 日以上前のデータを取得するクエリは避けてください。持続的な大容量クエリが必要な場合は、チケットを送信して、より高いクォータをリクエストしてください。
次のステップ
アプリケーション監視メトリクス：PromQL クエリで利用可能な ARMS メトリクスの完全な一覧
Prometheus HTTP API アドレス：各リージョンの API エンドポイント
アプリケーション概要：ARMS コンソールで特定のメトリクスの PromQL 式を確認