ラベルと注釈 - Amazon Managed Grafana

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ラベルと注釈

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業

ラベルと注釈には、アラートに関する情報が含まれています。ラベルと注釈はどちらも同じ構造です。名前付き値のセットですが、用途は異なります。ラベルの例、または同等の注釈は ですalertname="test"

ラベルと注釈の主な違いは、ラベルは他のすべてのアラートとの区別に使用され、注釈は既存のアラートに追加情報を追加するために使用されます。

例えば、2 つの高い CPU アラートを考えてみましょう。1 つは 用server1、もう 1 つは 用ですserver2。このような例では、最初のアラートに というラベルがありserver="server1"、2 server 番目のアラートに というラベルがある場合がありますserver="server2"。ただし、 や がサーバーの名前と CPU 使用率に置き換えserver175%られる場合など"The CPU usage for server1 is above 75%."、各アラートに説明を追加することもできます (これを行うラベルと注釈のテンプレート化方法については、「」のドキュメントを参照してください)。この種の説明は注釈としてより適しています。

ラベル

ラベルには、アラートを識別する情報が含まれています。ラベルの例は ですserver=server1。各アラートには複数のラベルを付けることができ、アラートのラベルの完全なセットはラベルセットと呼ばれます。アラートを識別するのはこのラベルセットです。

例えば、アラートに ラベルが設定されている{alertname="High CPU usage",server="server1"}のに対し、別のアラートに ラベルが設定されている場合があります{alertname="High CPU usage",server="server2"}。ラベルは同じですがalertname、ラベルは異なるため、これらは 2 つの個別のアラートserverです。

アラートのラベルセットは、データソースのラベル、アラートルールのカスタムラベル、 などの予約済みラベルの組み合わせですalertname

カスタムラベル

カスタムラベルは、アラートルールからの追加ラベルです。注釈と同様に、カスタムラベルには名前が必要です。その値には、アラートが発生したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。カスタムラベルのテンプレート作成方法に関するドキュメントは、 入手できます。

テンプレートでカスタムラベルを使用する場合、ラベルの値がアラートルールの連続評価間で変更されないようにすることが重要です。これにより、多数の個別のアラートが生成されます。ただし、テンプレートがアラートごとに異なるラベル値を生成しても問題ありません。例えば、クエリの値をカスタムラベルに入れないでください。値が変わるたびに新しいアラートセットが作成されます。代わりに注釈を使用します。

また、アラートのラベルセットに、同じ名前のラベルが 2 つ以上含まれていないことを確認することも重要です。カスタムラベルの名前がデータソースのラベルと同じ場合、そのラベルが置き換えられます。ただし、カスタムラベルの名前が予約済みラベルと同じ場合、カスタムラベルはアラートから省略されます。

‏注釈

注釈は、既存のアラートに追加情報を追加する名前付きペアです。Grafana には、、description、、 などsummary、推奨される注釈が多数ありますrunbook_urldashboardUIdpanelId。カスタムラベルと同様に、注釈には名前が必要です。その値には、アラートが発生したときに評価されるテキストコードとテンプレートコードの組み合わせを含めることができます。注釈にテンプレートコードが含まれている場合、アラートが発生したときにテンプレートが 1 回評価されます。アラートが解決されても、再評価されません。注釈のテンプレート作成方法に関するドキュメントは、こちら で入手できます。