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

アプリケーションタグ

アプリケーションタグは ARMS アプリケーションに適用されます。アプリケーションタグは、ARMS コンソールの アプリケーションモニタリング > アプリケーションリスト ページで表示または変更できます。アプリケーションタグは、アプリケーションのフィルタリング、権限の管理、コストの割り当てなどの目的で使用できます。

インスタンスタグ

各アプリケーションインスタンスは、同じアプリケーション名で 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.1}。

Kubernetes でのカスタムインスタンスタグの追加

'f:readyReplicas': {}
        'f:replicas': {}
        'f:updatedReplicas': {}
    manager: kube-controller-manager
    operation: Update
    subresource: status
    time: '2023-11-16T09:39:32Z'
  name: mall-gateway
  namespace: arms-apm-demo
  resourceVersion: '943537'
  uid: xxxd0b1bf76f42
spec:
  progressDeadlineSeconds: 600
  replicas: 1
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: mall-gateway
  strategy:
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      labels:
        gitVersion: '1.0.2'  # カスタムインスタンスタグを追加
        app: mall-gateway
        armsPilotAutoEnable: 'on'
        armsPilotCreateAppName: mall-gateway
    spec:
      containers:
      - env:
        - name: SERVICE_NAME

手動でインストールしたエージェントのタグ追加

#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：

ポッドラベルに 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 コンポーネントを設定します。

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

ARMS の [アプリケーション一覧] ページおよびアラートルールの作成時に、アプリケーションタグを使用してアプリケーションをすばやくフィルタリングできます。

タグベースのアクセス制御

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

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

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

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

   説明

   言語 列のアイコンは、アプリケーションのプログラミング言語を示します:

   : アプリケーションモニタリングに接続された Java アプリケーション。

   : アプリケーションモニタリングに接続された Go アプリケーション。

   : アプリケーションモニタリングに接続された Python アプリケーション。

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

3. アプリケーション詳細ページでは、インスタンスタグを使用してモニタリングデータをフィルタリングできます。たとえば、イメージバージョン番号に基づいてデータを比較および分析できます。

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

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

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

   説明

   言語 列のアイコンは、アプリケーションのプログラミング言語を示します。

   : アプリケーションモニタリングに接続された Java アプリケーション。

   : アプリケーションモニタリングに接続された Go アプリケーション。

   : アプリケーションモニタリングに接続された Python アプリケーション。

   [-]: Managed Service for OpenTelemetry に接続されているアプリケーション。

3. 左側のナビゲーションペインで、[Grafana ビュー] をクリックします。 ページの上部で、さまざまなタグを選択してメトリックをフィルターします。