Application Real-Time Monitoring Service:タグの追加と使用

アプリケーションタグ

アプリケーションタグは、アプリケーションレベルで適用されます。ARMS コンソールの アプリケーションモニタリング > アプリケーションリスト ページで、アプリケーションタグを表示または変更できます。アプリケーションタグを使用すると、アプリケーションのフィルタリング、アプリケーション権限の管理、コスト配分を行うことができます。

インスタンスのタグ

ARMS では、1 つのアプリケーションが複数のアプリケーションインスタンスで構成されることがあります。各インスタンスは、同じアプリケーション名で ARMS に接続されたアプリケーションプロセスを表します。アプリケーションタグとは異なり、インスタンスのタグはインスタンスレベルで適用されるため、同じアプリケーション内の異なるインスタンスが、それぞれ異なるインスタンスのタグを持つことができます。

Kubernetes 環境でアプリケーションモニタリングに自動的に接続されるアプリケーションインスタンスの場合、ARMS は以下のデフォルトのインスタンスのタグを追加します。

デフォルトのインスタンスのタグに加えて、カスタムインスタンスのタグを追加できます。アプリケーションインスタンスは、そのアプリケーションからタグを完全に継承します。ARMS がアプリケーションインスタンスに対して生成するモニタリングデータには、そのすべてのインスタンスのタグが含まれます。

例：

次の図に示すように、アプリケーション my-app には 2 つのインスタンスがあります。ARMS がインスタンス B に対して生成するメトリックデータには、次のタグが含まれます：{env: Dev, team: Observability, app: my-app, workloadKind: Deployment, workloadName: my-app, clusterName: ClusterA, namespace: nsA, gitVersion: 1.0.2}。

Kubernetes アプリケーションへのカスタムインスタンスのタグの追加

手動エージェントを使用するアプリケーション

#export ARMS_HOST_TAGS=key1:value1&key2:value2
export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101"

#export ARMS_HOST_TAGS=key1:value1&key2:value2
export ARMS_HOST_TAGS="gitVersion:1.0.2&ip:192.168.1.101"

方法 1：

Pod ラベルにプレフィックス app.customAppKey. がある場合、ARMS はそれをインスタンスのタグではなく、アプリケーションタグとして識別します。

たとえば、次のコードでは、ARMS はアプリケーションタグ env: dev をこのワークロードに関連付けられたアプリケーションに追加します。

  template:
    metadata:
      labels:
        app.customAppKey.env: dev
        app: mall-gateway
        armsPilotAutoEnable: 'on'
        aliyun.com/app-language: golang  # Go アプリケーションで言語を識別するために必要です。Java アプリケーションでは不要です。
        armsPilotCreateAppName: mall-gateway

方法 2：

既存の Pod ラベルをアプリケーションタグとして再利用するには、ack-onepilot コンポーネントを設定します。

アプリケーションのフィルター

アプリケーションタグを使用すると、[アプリケーション一覧] ページやアラートルールを作成する際に、アプリケーションをすばやくフィルターできます。

タグベースの権限管理

アプリケーションタグに基づいて RAM 権限を管理できます。詳細については、「アプリケーションモニタリングのカスタム RAM 認可ポリシー」をご参照ください。

インスタンスのタグによるデータのフィルター

1. ARMS コンソールにログインします。 左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーションリスト] を選択します。

2. [アプリケーションリスト] ページで、上部のリージョンを選択し、対象のアプリケーション名をクリックします。

   説明

   [言語] 列のアイコンは、以下を表します：

   ：アプリケーションモニタリングに接続されている Java アプリケーション。

   ：アプリケーションモニタリングに接続されている Go アプリケーション。

   ：アプリケーションモニタリングに接続されている Python アプリケーション。

   -：OpenTelemetry 向けマネージドサービスに接続されているアプリケーション。

3. アプリケーション詳細内のさまざまなページで、インスタンスのタグによってモニタリングデータをフィルターできます。 たとえば、イメージのバージョン番号に基づいてデータを比較・分析できます。

Grafana ビューでのタグによるメトリクスのクエリ

1. ARMS コンソールにログインします。左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーション一覧]を選択します。

2. [アプリケーションリスト] ページで、上部のリージョンを選択し、対象のアプリケーション名をクリックします。

   説明

   [言語] 列のアイコンは、以下を表します：

   ：アプリケーションモニタリングに接続されている Java アプリケーション。

   ：アプリケーションモニタリングに接続されている Go アプリケーション。

   ：アプリケーションモニタリングに接続されている Python アプリケーション。

   -：OpenTelemetry 向けマネージドサービスに接続されているアプリケーション。

3. 左側のナビゲーションウィンドウで、[Grafana ビュー] をクリックします。 ページの上部で、異なるタグを選択して、対応する監視メトリクスを表示します。