• ログイン

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

ミューティングルール:通知を抑制します

システムに問題が発生した場合、アラートはタイムリーな通知を送信します。表示する必要がないことがわかっている通知がある場合があります。ミューティングルールを使用して、不要なメッセージによる攻撃を防ぐことができます。

不要な通知で共通の要素を見つけたら、他の通知を通過させながら、それらの要素を具体的に対象とするミューティングルールを定義できます。通知がミュートされている場合でも、アラートはそれらの違反に関するデータを収集します。ミューティングルールはアラートプロセスに干渉せず、通知が送信される直前の時点で適用されます。

ミューティングルールを管理する

ミューティングルールの条件は、ミューティングの対象となる違反を定義する属性、演算子、および値で構成される個々の式のセットです。

ミューティングルールを作成、有効化、無効化、および管理できます。 one.newrelic.comにアクセスし、上部のナビゲーションで[ Alerts&AI ]をクリックしてから、[Mutingrules]をクリックします。ミューティングルールをいつでも有効または無効にします。

ルールには、次のいずれかのステータスがあります。

  • アクティブ:ミューティングが有効でアクティブです。
  • スケジュール済み:ミューティングは有効になっていますが、まだアクティブではありません(将来のスケジュールがあります)。
  • 終了:ミューティングは有効になっていますが、アクティブではなくなりました(将来のスケジュールはありません)。
  • 非アクティブ:ミューティングが無効になっています。

one.newrelic.com >アラートとAI>ミューティングルール:複雑なミューティングルールを作成して、不要な通知の小さなセットまたは大きなセットをターゲットにすることができます。

ミューティングルールを作成する

ヒント

ミューティングルールを作成する前に、違反通知を生成するポリシーと条件を作成する必要があります。

ミューティングルールを作成するには、[ミューティングルール]画面で[ +ルールを追加]をクリックします。ミューティングルールの名前と説明を入力し、ルールを適用するアカウントを選択します。

次に、違反フィルターを作成します。 の違反イベント属性 のサブセットを使用できます(具体的には、 accountIdconditionIdconditionNameentity.guidnrqlEventTypenrqlQuerypolicyIdpolicyNamerunbookUrl (としてconditionRunbookUrl )、 tags.<NAME> 、およびtargetName )と つの部分条件演算子 。値は、アラートポリシーIDや条件名などの違反属性の1つと比較できます。

one.newrelic.com >アラートとAI>ミューティングルール:複雑なミューティングルールを作成して、不要な通知の小さなセットまたは大きなセットをターゲットにすることができます。

ミューティングルールをスケジュールする

必要に応じて、ミューティングルールをスケジュールできます。

これを行うには、開始時刻または終了時刻、あるいはその両方を選択します。オプションで、ミューティングルールを1日継続するように設定できます。

ミューティングルールスケジュールのタイムゾーンを選択することもできます。デフォルトは、ユーザー設定で選択されたタイムゾーンです。

ミューティングルールをスケジュールするための柔軟で強力なオプション。

ミューティングルールを毎日、毎週、または毎月繰り返すようにスケジュールできます。毎週繰り返すようにスケジュールされているミューティングルールには、繰り返す曜日を選択するオプションが含まれています。日が選択されていない場合、毎週の繰り返しは、デフォルトで、ミューティングルールの開始がスケジュールされている曜日に繰り返されます。

重要

[曜日を繰り返す]チェックボックスは、[開始日]フィールドと[終了日]フィールドを上書きします。開始日を設定し、曜日も選択した場合、ミューティングルールは開始日後の最初の日に適用されます

特定の日付または特定の発生回数を選択して、再発をいつ終了するかを指定することもできます。

NerdGraphを使用してミューティングルールを管理する

NerdGraphでは、ミューティングルールで次のクエリとミューテーションを使用できます。スキーマの詳細は、 APIExplorerで確認できます。

  • actor.account.alerts.mutingRule:IDでミューティングルールを取得します。
  • actor.account.alerts.mutingRules:アカウントのミュートルールのリストを取得します。
  • alertsMutingRuleCreate:アカウントのミュートルールを作成します。
  • alertsMutingRuleUpdate: IDとアカウントIDでミューティングルールを更新します。
  • alertsMutingRuleDelete: IDとアカウントIDでミュートルールを削除します。

このドキュメントでは、いくつかのサンプルクエリとミューテーションの例を示しました

ミューティングルールには、次のフィールドとコンポーネントがあります。

ミューティングルール

フィールドとコンポーネント

id

ミューティングルールの一意の識別子。

name必須

ミューティングルールのわかりやすい名前のテキストフィールド。これは、ルールを一覧表示または参照するときに使用されます。名前が一意である必要はありませんが、お勧めします。

description

これは、ミューティングルールを説明するオプションのテキストフィールドです。これは、ミューティングルールにより多くのコンテキストを提供するための便利な方法です。このデータは、管理表示の目的でのみ使用されます。

accountId

ミューティングルールのアカウントID。ミュートルールは、単一のアカウントで発生する違反にのみ影響します。複数のアカウント間で違反をミュートするには、アカウントごとに個別にミュートルールを作成する必要があります。

createdAt

ミューティングルールが作成されたときのタイムスタンプ(UTC)。

createdBy

ミューティングルールを作成した人のユーザーID。

updatedAt

ミューティングルールが最後に変更されたときのタイムスタンプ(UTC)。

updatedBy

ミューティングルールを最後に変更した人のユーザーID。

enabled

ミューティングルールを有効または無効にします(ブール値)。ミューティングルールは手動で有効または無効にする必要があります。

condition

対象とする違反を定義する個々の式のセット。ミューティングルールの条件は次のとおりです。

  • operator:条件のセットを組み合わせる方法を定義するブール演算子ANDまたはOR

  • conditions:違反内の属性を対象とする個々の式(サブ条件)のセット。これらは、 operatorに基づいて一緒に評価されます。 1つのミューティングルールに対して最大20のサブ条件を設定できます。

    サブ条件には次のものがあります。

  • attribute:違反内の単一の属性。違反イベント属性のリストについては、こちらをご覧ください。

  • operator:選択した違反属性を条件の値と比較するために使用される比較関数。サブ条件演算子のリストについては、ここにアクセスしてください。

  • values:選択した違反属性と比較する文字列値の配列。ミューティングルールが条件を評価するとき、必要に応じて、値は文字列から強制変換されます。 INなどの複数の値との比較をサポートする演算子を使用する場合は、最大500個の値を使用できます。

schedule

MutingRuleが違反を積極的にミュートする時間枠。

  • startTime:ミューティングルールの開始時刻を表す日時スタンプ。これは、オフセットのないローカルISO8601形式です。例: '2020-07-08T14:30:00'
  • endTime:ミューティングルールがいつ終了するかを表す日時スタンプ。これは、オフセットのないローカルISO8601形式です。例: '2020-07-15T14:30:00'
  • timeZone:ミューティングルールのスケジュールに適用されるタイムゾーン。例:'America/Los_Angeles'。ウィキペディアのtzデータベースのタイムゾーンのリストを参照してください。
  • 繰り返し:ミューティングルールのスケジュールが繰り返される頻度。繰り返されない場合は、nullを使用してください。オプションは、毎日、毎週、毎月です。
  • endRepeat:ミューティングルールスケジュールの繰り返しが停止した日時スタンプ。これは、オフセットのないローカルISO8601形式です。例:「2020-07-10T15:00:00」。注:ミューティングルールのスケジュールを終了するには、 endRepeatまたはrepeatCountのいずれかを使用する必要があります。両方のフィールドを一緒に指定しないでください。
  • repeatCount:ミューティングルールスケジュールが繰り返される回数。これには元のスケジュールが含まれます。たとえば、2のrepeatCountは1回繰り返されます。 3のrepeatCountは2回繰り返されます。注: repeatCountまたはendRepeatのいずれかを使用して、ミューティングルールのスケジュールを終了できます。両方のフィールドを一緒に指定しないでください。
  • weeklyRepeatDays:繰り返しフィールドが「WEEKLY」に設定されている場合にミューティングルールを繰り返す必要がある曜日。例:['MONDAY'、'WEDNESDAY']。

ミューティングルールのしくみ

通知を抑制またはミュートするために、デフォルトのアラートライフサイクルの最後にミュートルールが適用されます。既存のポリシーや条件を無効にすることはありません。たとえば、メンテナンスウィンドウや展開など、既知のシステムの中断中に通知をミュートできます。システム障害違反の通知はミュートされていますが、システム障害違反は引き続き識別されます。

ミューティングルールは、違反イベントの属性と一致する一連の条件を使用します。ミューティングルールは、次の方法を教えてくれます。

  1. 作成された後、インシデントが開かれる前に、個々の違反を特定します。
  2. デフォルトの条件をオーバーライドして、「ミュート」する必要があることを示します。

現在、違反をミュートすると、ミュートされた違反のみを含むインシデントが通知を送信しないことを除いて、通常のアラートインシデントのライフサイクルが維持されます。

ミューティングルールは特定の違反を上書きします。既存のポリシーや条件を無効にすることはありません。これにより、多数のエンティティを対象とするポリシーまたは条件の対象となる可能性のある特定のエンティティからの違反をミュートできます。これにより、システムのサブセットでメンテナンスを実行しているときに、監視を過度にミュートする必要もなくなります。

ミューティング動作

次の表は、アラートインシデントのライフサイクルがミュートされた違反によってどのように影響を受けるかを示しています。

もしも

それから

イベント:インシデントが発生します

ミュートされていない違反が原因でインシデントが発生します

「未解決のインシデント」通知が送信されます(デフォルト)。

ミュートされた違反原因でインシデントが発生します

「未解決のインシデント」通知は送信されません(ミュートされます)。

イベント:未解決のインシデントに違反が追加されました

すでに開いているインシデントに新しいミュート違反が追加されます

通知アクションはトリガーされません(デフォルト)。

ミュートされていない新しい違反が未解決のインシデントに追加されます

「未解決のインシデント」通知は送信され**ていません**

「未解決のインシデント」通知が送信されます。

ミュートされていない新しい違反が未解決のインシデントに追加されます

「未解決のインシデント」通知はすでに送信されています

通知アクションはトリガーされません(デフォルト)。

イベント:インシデントは終了しました

インシデントはクローズされました

「未解決のインシデント」通知は送信されていません

「インシデントのクローズ」通知は送信されません

インシデントはクローズされました

「未解決のインシデント」通知が送信されました

「インシデントのクローズ」通知が送信されます。

イベント:インシデントが確認されました

インシデントが確認されました

「未解決のインシデント」通知は送信されていません

「インシデント確認済み」通知は送信されません

インシデントが確認されました

「未解決のインシデント」通知が送信されました

「インシデント確認済み」通知が送信されます。

ワークフローによる動作のミュート

トリガーされた違反はインシデントと1:1の比率であるため、違反がミュートされると、一致するインシデントもミュートされます。ワークフローは、1つ以上のインシデントが発生する可能性のある問題によってトリガーされるため、ミュートされたインシデントとミュートされていないインシデントが組み合わされたシナリオが存在する可能性があります。

各問題には、次のいずれかのミューティング状態があります。

  • 完全にミュート(FULLY_MUTED) :問題の未解決のインシデントがすべてミュートされています(デフォルト値)。
  • 部分的にミュート(PARTIALLY_MUTED) :少なくとも1つの未解決のインシデントがミュートされ、1つの未解決のインシデントがミュートされていない問題。
  • ミュートされていません(NOT_MUTED):未解決のミュートされたインシデントがない問題。

ミュートされた違反とインシデントを表示する

オープンまたはクローズされたインシデントを表示すると、違反とインシデントはMutedとしてマークされます。次のセクションでは、これらのミュートされた違反とインシデントのいくつかと、それらを見つけることができる場所を示します。

を使用してファセット結果をミュートする tags.

ファセットクエリの結果をミュートするには、 tags.FACETED_ATTRIBUTE属性を使用します。ここで、 FACETED_ATTRIBUTEは、NRQL FACETクエリを実行した属性を表します。例:NRQLアラート条件のクエリにFACET hostが含まれている場合、 tags.hostを使用してそのFACET属性をターゲットにできます。

NRQL条件クエリは、複数のファセット属性を受け入れることができます。集約されたイベントまたはメトリック時系列の属性からフィルタリングできるようにする場合は、それらの属性をNRQLクエリFACET句に追加する必要があります。例: FACET host, region, cluster

tags.の使用例については、ミューティングルールの作成を参照してください。

サブ条件演算子

以下は、ミューティングルールを作成するときに属性を比較するために使用できる論理演算子です。使用されているこれらの例については、 を参照してください。

  • EQUALS:指定された値が違反属性値と等しい場合。
  • NOT_EQUALS:指定された値が違反属性値と等しくない場合。
  • IN:違反属性値が提供された値のリストに存在する場合(最大500)。
  • NOT_IN:違反属性値が提供された値のリストに存在しない場合(最大500)。
  • CONTAINS:指定された値の文字列が違反属性値に存在する場合。
  • NOT_CONTAINS:指定された値の文字列が違反属性値に存在しない場合。
  • ANY注意:この演算子の条件は、アカウントのすべての違反をミュートします。
  • IS_BLANK:違反属性値が空白の場合。ヌル、空の文字列など。
  • IS_NOT_BLANK:違反属性値が空白でない場合。ヌル、空の文字列など。
  • STARTS_WITH:違反属性値が指定された値文字列で始まる場合。
  • NOT_STARTS_WITH:違反属性値が指定された値文字列で始まらない場合。
  • ENDS_WITH:違反属性値が指定された値文字列で終わる場合。
  • NOT_ENDS_WITH:違反属性値が指定された値文字列で終わっていない場合。

ミューティングの例

NerdGraphへのリクエストの詳細については、 GraphQLチュートリアルを含むNerdGraphドキュメントを参照してください。

Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.