条件の種類によっては、インシデント対応を改善したり、他のシステムで使用したりするために有用な情報をダウンストリームに渡すカスタム インシデントの説明を定義できます。UI または GraphQL でカスタム インシデントの説明を作成できます。
要件
カスタム インシデントの説明機能は、次の場合に使用できます。
- NRQL警告条件
- インフラ監視のアラート状態
カスタム インシデントの説明フィールドの最大文字サイズは 4000 です。
カスタム インシデントの説明とは何ですか?
条件の種類によっては、条件とそのインシデントに関する情報を下流に渡すカスタム インシデントの説明を作成できます。説明を使用すると、次のことができます。
- 症状の理由を捉える
- モニタリングする信号の定義
- 次のステップを決める
- ダウンストリームシステムへのメタデータの追加
Custom incident descriptionフィールドを使用すると、インシデントの生成時に汎用セクションを特定の値に置き換える一般的なテンプレート構造を使用できます。 たとえば、説明にこれを使用したとします。
This is my condition name : The hostname is :
この状態から発生したインシデントの詳細が入力され、次のような通知が届きます。
This is my condition name : My Great Alert ConditionThe hostname is : ip-123-45-67-89.us-west-1.compute.internal
カスタム インシデントの説明を作成する
one.newrelic.com > All capabilities > Alerts & AI > Alert conditions (Policies) > (select a policy) > (select a condition): フィールドを開くには+ Add custom incident descriptionをクリックします。
NRQL アラートの専用フィールド、またはインフラストラクチャ アラートの [この条件の説明] セクションを使用して、カスタム インシデントの説明を作成できます。
カスタム インシデント説明テンプレートの例
カスタム インシデント説明テンプレートの例を次に示します。
This is my condition name : The hostname is : Owning Team: Product: ec2VpcId: Service name : AWS Region : AWS Availability Zone: Department : Environment: Cluster: Cluster Role: EC2 Instance Type: EC2 InstanceID: EC2 AmiId: EC2 Root Device Type:
属性の使い方
カスタム インシデントの説明で使用できる属性は、 インシデント イベントに関連付けられた属性のサブセットです。使用可能な属性とその使用方法の詳細を次に示します。
インシデント イベント属性: カスタム インシデントの説明で使用できる標準属性には、形式
{{AN_ATTRIBUTE}}
を使用します。例えば:The target name is :タグ属性:タグには、
{{tag.TAG_NAME}}
の形式を使用します。タグには次の2つのタイプがあります。シンボル関連のタグ:For infrastructure conditions only. シンボル エクスプローラーMetadata and tags にアクセスしてサービスの の下を参照するか、インシデントの詳細を表示することで、使用可能な シンボル関連のタグ を見つけることができます。カスタム インシデントの説明でタグを使用する例を次に示します。
The AWS region is :Responsible team :ファセット句タグ: For NRQL conditions only. NRQL 条件で
FACET
句が使用されている場合は、tag
フォーマットを使用して、カスタム インシデントの説明でそれらの値を使用できます。 たとえば、NRQL クエリにFACET hostName, cluster
含まれている場合は、次のように使用できます。The host is :The cluster is :
タグ名にはホワイトスペースを含めることができないことに注意してください。展開された値は空白を含むことができますが、タグの名前自体は含みません。
GraphQL を使用してカスタム インシデントの説明を作成する
その説明を使用してGraphQLミューテーションを介して、NRQLアラート条件でカスタムインシデントの説明を作成できます。
ここには空の変異テンプレートがあります。
mutation { alertsNrqlConditionStaticUpdate( accountId: YOUR_ACCOUNT_ID id: "YOUR_CONDITION_ID" condition: { description: "" } ) { YOUR_CUSTOM_INCIDENT_DESCRIPTION }}
カスタム インシデントの説明を使用したミューテーションの例を次に示します。
mutation { alertsNrqlConditionStaticUpdate( accountId: 123456 id: "123456" condition: { description: "timestamp : {{timestamp}} \n accountId : {{accountId}} \n type : {{type}} \n event : {{event}} \n description : {{description}} \n policyId : {{policyId}} \n policyName: {{policyName}} \n conditionName : {{conditionName}} \n conditionId : {{conditionId}} \n product : {{product}} \n conditionType : {{conditionType}} \n RunbookUrl : {{runbookUrl}} \n nrqlQuery : {{nrqlQuery}} \n nrqlEventType : {{nrqlEventType}} \n targetID : {{targetId}} \n targetName : {{targetName}} \n commandLine : {{tag.commandLine}} \n entityGuid : {{tag.entityGuid}} \n entityName : {{tag.entityName}} \n fullHostname : {{tag.fullHostname}} \n instanceType : {{tag.instanceType}} \n processDisplayName : {{tag.processDisplayName}}" } ) { description }}
- NRQL 条件と NerdGraph API の使用についての詳細は、 NerdGraph API をご覧ください。NRQL条件のアラート 。
- インフラストラクチャ監視条件の場合、 インフラストラクチャ監視アラート条件を作成するときにカスタム インシデントの説明を作成できます。
- カスタム インシデントの説明を構成する方法については、サンプル テンプレートと属性/タグの説明を参照してください。
Slackでユーザーに言及したり、チャンネルを通知する
Slackに送信されることが分かっている説明を作成する場合は、ユーザーを@mentionしたり、チャンネル全体の通知 (たとえば、 @hereまたは@channel ) を生成したりすることができます。 これを実現するには、説明にユーザー ID またはチャネル全体の通知を<
と>
文字で囲んで含めるだけです。
ここでは、ユーザーに言及する場合の例を示します。
Attention <@LewCirne>
ここでは、チャネル全体の通知を生成する例を示します。
Attention <!channel>
重要
Incoming Webhookのチャネル全体の通知のSlack規則では、 @
の代わりに!
プレフィックスを使用することに注意してください。たとえば、 !here
または!channel
。