ワークフロー

ワークフローでは、課題に関する通知をいつ、どこで受け取るかをコントロールし、適切な情報を関連する担当者やチームにトンネリングし、課題の通知をNew Relicの追加データで充実させることができます。

イシューとは？

問題は、症状の根本的な問題を説明するインシデントのグループです。新しいインシデントが作成されると、インシデント インテリジェンスによって問題がオープンされ、他の未解決の問題の相関関係が評価されます。詳細については、 「インシデント インテリジェンスの使用」を参照してください。

ワークフローはどのようにトリガーされますか?

ワークフローは、ワークフロー フィルターと一致する通知トリガーに一致する課題の課題イベントによってトリガーされます。 ワークフローはデフォルトで推奨トリガーを使用して構成されていますが、3 つの点をクリックしてNotify whenを選択すると、宛先ごとに通知をトリガーするタイミングを制御できます。 Activated通知トリガーも有効にする必要があります。

次のイベントは、ワークフローをトリガーし、関連する宛先エンドポイントに通知を送信します。

必要な権限

ワークフローを使用するには、特定の 権限が必要です。

• 宛先にアクセスするには: Applied intelligence > Destinations または Alertsに対するView 権限。
• ワークフローにアクセスするには: Applied intelligence > Workflowsに対するView 権限。
• ワークフローを作成するには: Applied intelligence > Workflows および Applied intelligence > Channelsに対するModify 権限。
• ワークフローを変更するには: Applied intelligence > Workflows に対するModify 権限、および Applied intelligence > Channels と applied_intelligence.create.workflowに対するすべての権限。
• ワークフローを削除するには: Applied intelligence > Workflows および Applied intelligence > Channelsに対するDelete 権限。

ワークフローの追加

ワークフロー機能は、 **Alerts **メニューの下にあります。

1. one.newrelic.com > All capabilities > Alerts > Enrich and Notify > Workflow > Add a workflowに移動します。

2. ワークフローの名称を入力してください。このフィールドは必須で、ユニークである必要があります。

3. ワークフローを使用して、問題をフィルタリングし、関連する宛先に送信します。クエリを作成して、適切な問題をフィルター処理できます。

   ヒント

   WARNINGのインシデントに個別の通知を設定するには、優先度がHIGHに等しい問題でフィルタリングします。

4. 属性、演算子、および値を選択してクエリを作成し、伝えたい問題を絞り込みます。

   ヒント

   ワークフロー フィルターには、過去の問題のデータと、条件メタデータ (条件名など) の静的な値が自動的に入力されます。 探している値が見つからない場合は、値を入力してEnter newを選択します。 フィルターが過去の問題と一致しないという警告が表示される場合があります。

5. 推奨: チーム タグで問題をフィルター処理して、エンティティが問題に含まれている場合にすべてのチームに通知できるようにします。手順は、以下のデモにあります。

   タグの使用に関するヒントについては、 ワークフロー パターンに関するサポート フォーラムの投稿を参照してください。

6. オプションです。データを充実させる

   データを充実させる方法

   現在、Webhook および Jira の送信先には JSON または数値出力のみを送信できます。さらに、Enrich データの結果を指す ワークフロー変数を使用して、JSON を AWS EventBridge に送信することもできます。また、画像は Slack、PagerDuty、ServiceNow (アプリ)、電子メールなどの他の送信先にのみ送信できます。 Webhook と Jira でより良い結果を得るには、 count 、 min 、 maxなどの単一値出力を持つクエリを使用します。

   エンリッチメントの使用に関する詳細:

   • エンリッチメントは、アラート通知にNRQLクエリの結果を追加することで、アラート通知に追加のコンテキストを与えることができます。

   • ワークフローを充実させるツールは、クエリビルダと似ています。

   • NRQL クエリの結果は通知メッセージに含まれます。

   • ワークフローのためにクエリを作成すると、リアルタイムで実行され、クエリの結果がエンリッチメントの価値となります。

   • 空の結果が返された場合でも、有効なクエリをワークフローに保存できますが、エンリッチメントを保存する前にクエリを実行する必要があります。問題固有の変数を使用してクエリを実行することもできます。例えば {{entitiesData.ids}}

   • エンリッチメントの例については、 「ワークフロー データ エンリッチメントの例」を参照してください。

   • 注：ワークフローで送信される通知のペイロードに結果をどのように含めるかを決定するために、クエリ名は一意である必要があります。

     重要

     この段階で、エンリッチメントの視覚的表現が Slack と電子メールに送信されます。ServiceNow および JIRA の宛先の場合、単一値の結果を持つ NRDB クエリに制限することをお勧めします。たとえば、 count 、 min 、またはmaxです。

     ワークフローあたりのエンリッチメントの最大数は 2 です。

7. 通知する1つまたは複数の送信先を選択し、任意のメッセージを追加します。

   ヒント

   任意の宛先チャンネルで入力を開始すると、変数メニューが開きます。 変数の名前が表示されます。これは実行時に変数の値に置き換えられます。エンリッチャーの結果を使用するには、その名前を使用します。

   ノーティファイア

   • ワークフローを保存して有効にするには、ノーティファイアを含める必要があります。
   • 通知機能を設定するには、通知先を設定する必要があります。
   • Destinationメニュー項目を使用するか、各宛先チャンネル画面の宛先選択ドロップダウンのCreate new destination itemを使用して設定できます。
   • 通知先には、サードパーティのプラットフォームに通知を送信するために必要な認証情報と、当社の課題のフィールドを送信先のプラットフォームのフィールドにマッピングすることで、送信されるメッセージをカスタマイズするオプションが含まれます。
   • 送信先の設定やメッセージテンプレートの設定方法については、 「通知」に関するドキュメント をご参照ください。
   • (オプション) 通知者ごとに取得する通知をマークできます。それ以外の場合、通知はデフォルトで各ノーティファイアに送信されます。

8. 通知者の要件を満たしたら、 update messageをクリックします。

9. オプション: ワークフローをテストします。アカウントの既存のデータを使用して、新しい構成でサンプル通知を送信します。テストは、フィルターに一致する既存の問題がある場合にのみ機能します。データがない場合は、次のメッセージが表示されます： We don't see any issues matching your filter. That doesn't mean it won't work 。

10. Update workflowをクリックしてワークフローを完了します。

発行通知ログ

問題通知ログは、ワークフローによって生成されたすべての通知を追跡するための詳細な記録をユーザーに提供します。この情報により、問題のトラブルシューティングが行われ、ワークフローのパフォーマンスが監視され、通知が正しい宛先に送信されていることを確認できます。その結果、ユーザーは発生する可能性のある問題を迅速に特定し、必要に応じて修正措置を講じることができます。

問題通知ログにアクセスするには、 one.newrelic.com > Alerts > Workflowsに移動し、 Issue notification logをクリックします。

問題通知ログの移動

問題通知ログには、次の列が表示されます。

1. Time: この列には、ワークフロー通知が送信された時間が表示されます。

2. Status: この列には、通知のステータスが表示されます。

   • 送信済み: New Relic から通知が正常に送信されました。
   • 失敗: 通知は New Relic から正常に送信されませんでした。
   • バウンス: 受信側のメール サーバーがメールを配信できないか、配信しません。 これは通常、電子メール アドレスが無効であるか、電子メールの受信トレイがいっぱいであるために発生します。 バウンスされた電子メール アドレスは、今後のメール送信では削除されます。
   • ドロップ: 電子メール アドレスがすでにバウンスされているか、アドレスが当社の電子メールの購読を解除しているか、アドレスが当社の電子メールをスパムとしてマークしているため、電子メール クライアントは電子メールの送信を試行しませんでした。
   • 延期: 接続などの一時的な問題により、最初の試行で電子メールが送信されませんでした。 もう一度試行されるため、延期された通知は後で成功したり、返送されたりする可能性があります。

3. Destination: この列には、ワークフロー通知を受信する宛先の種類 (Slack や電子メールなど) が表示されます。

4. Operation: 送信された通知の種類 (例: 通知、クローズ、コメント、確認、テスト)。

5. Issue Name: この列には、ワークフロー通知をトリガーした問題の名前が表示されます。

6. Trigger Event: この列には、ワークフロー通知をトリガーした発行イベントが表示されます。 イベントをクリックすると、ワークフローがどのようにトリガーされるかに関する詳細情報が表示されます。

7. Workflow: この列には、通知をトリガーしたワークフローが表示されます。

8. Error Details: 通知が失敗した場合、この列には追加の詳細が表示されます。

9. Notification Result: この列には、通知が正常に送信された場合、サードパーティの証拠 (Slack スレッドや JIRA チケットなど) へのリンクが表示されます。

10. Payload: これは、Webhook の宛先に送信された通知で使用でき、送信された通知の JSON ペイロードを表示します。

NrAiNotification

NrAiNotification イベントを使用して、問題通知からのすべての情報をクエリできます。

このクエリを使用して、ワークフローから送信されたすべての通知を宛先タイプごとに表示します。

FROM NrAiNotification
SELECT count(*)
FACET destinationType

詳細を表示

ユーザーは、問題通知ログの任意の行をクリックすると、追加の詳細を表示できます。これにより、エラーの詳細 (該当する場合) とサードパーティの通知へのリンクが表示されます。