すべてのプロダクト
Search
ドキュメントセンター

Simple Log Service:ラベルと注釈を追加する

最終更新日:Aug 29, 2024

アラートルールを作成するときに、ラベルと注釈を指定できます。 ラベルは、アラートのノイズ除去、通知ルートの管理、通知チャネルの割り当てに使用されます。 注釈は、アラートテンプレートを設定し、アラートをディスパッチするために使用されます。

ラベル

使用シナリオ

  1. アラートの重複除去

    ラベルはアラートの属性を識別し、重複アラートの削除に役立つアラートフィンガープリントの一部です。 2つのアラートのラベルが同じ場合、1つのアラートのみが保持されます。 アラートフィンガープリントの動作原理については、「フィンガープリントに基づく重複解消アラート」をご参照ください。

    // Alert1
    {
      "aliuid": "12345",
      "project": "Project1",
      "alert_id": "alert-123",
      "labels": {
        "host": "host-1"
      },
      "annotations": {
        "title": "High CPU utilization",
        "desc": "Current CPU utilization is 90%"
      }
    }
    
    // Alert2
    {
      "aliuid": "12345",
      "project": "Project1",
      "alert_id": "alert-123",
      "labels": {
        "host": "host-1"
      },
      "annotations": {
        "title": "High CPU utilization",
        "desc": "Current CPU utilization is 95%"
      }
    }
  2. コンテンツテンプレートの参照ラベル

    ラベルはマップタイプです。 アラートルールにラベルを追加すると、${labels} を介してアラートテンプレートのコンテンツ内のラベルを参照できます。

    image

  3. アラートのノイズ除去

    アラートポリシーでは、ラベルをマージ条件として使用してアラートをノイズ除去できます。 たとえば、次の図に示すように、アラートIDとすべてのラベルを使用してアラートをマージします。 詳細については、「Merge by」をご参照ください。

    image

  4. 通知チャネルの割り当て

    アラート管理システムおよび通知管理システムは、アラートを管理し、ラベルに基づいて通知チャネルを割り当てます。 たとえば、次の図に示すように、アクションポリシーを設定するときに、ラベルに基づいてさまざまなアクショングループを設定できます。

    image

ラベルの追加方法

アラートルールの作成時にラベルを追加できます。 たとえば、次の図に示すように、ラベルenvteamを追加します。

biaoqian

さらに、グループ評価パラメーターの設定時に指定されたフィールドは自動的にラベルとして使用されます。

image

注釈

使用シナリオ

アラート管理システムおよび通知管理システムは、アラートを管理し、注釈に基づいて通知チャネルを割り当てる。 たとえば、アラートポリシーの注釈に基づいて異なるグループマージを設定できます。 アクションポリシーでは、注釈に基づいてさまざまなアクショングループを設定できます。

image

注釈の追加方法

アラートルールを作成するときに注釈を追加します。 たとえば、次の図に示すように注釈を追加します。

image

注釈コンテンツを設定するときは、グループ評価で組み込み変数または参照フィールド変数を使用できます。 グループ評価でフィールド変数を参照する場合、アラートがトリガーされたときの実際の値は対応する属性値です。 使用される組み込み変数を以下の表に示します。

変数

説明

__count__

これらの行がグループ化された後の各グループの行数。 グループパラメーターをグループ化なしに設定すると、すべてのデータが 1 つのグループに含まれます。

__pass_count__

行のグループ化後に、各グループで指定された条件を満たす行の数。 グループパラメーターをグループ化なしに設定すると、すべてのデータが 1 つのグループに含まれます。

__0_count__

最初のクエリに対して返される行数。

__1_count__

2 番目のクエリに対して返される行数。

__2_count__

3 番目のクエリに対して返される行数。

aliuid

Alibaba Cloud アカウントの ID。

alert_instance_id

アラートの ID。

alert_id

アラートルールのID。

alert_name

アラートルール名。

project

アラートルールが属するプロジェクト。

自動注釈

自動注釈は、警告注釈の補足です。 アラートルールを作成するときに、[注釈の自動追加] スイッチをオンにすると、フィールドが自動的に注釈に追加されます。

説明
  • フィールドに複数の値が存在する場合、最初の値が注釈に追加されます。

  • __count__ 組み込みフィールドは、set操作の結果の行数を示します。

  • グループ化

    アラートルールを作成するときに、グループ評価カスタムラベルに設定し、[注釈の自動追加] スイッチをオンにします。 次に、セット操作の結果のグループ化されていないフィールドと __count__ 組み込みフィールドが自動的にアノテーションに追加されます。

    たとえば、set操作の結果にはhostpvが含まれ、結果はhostフィールドでグループ化されます。 [注釈の自動追加] スイッチをオンにすると、pvフィールドと __count__ フィールドが注釈に追加されます。

    image

  • グループ化なし

    アラートルールを作成するときは、グループ評価[グループ化なし] に設定し、[注釈の自動追加] スイッチをオンにします。 次に、すべてのフィールドと、set操作の結果の __count__ 組み込みフィールドが自動的にアノテーションに追加されます。

    例えば、集合演算の結果は、hostおよびpvを含む。 [注釈の自動追加] スイッチをオンにすると、hostpv、および __count__ フィールドが注釈に追加されます。

    image