Notifications と Integrations
概要
Work Management は、Notifications やチケットを自動または手動で生成するためのサードパーティインテグレーションを作成する機能を提供します。
- 自動: 新しいワークアイテムが作成されるたびに、新しいチケットまたは Notifications が生成されます。
- 手動: ユーザーは特定のワークアイテムに対してチケットまたは Notifications を作成することを選択します。
Work Management をサードパーティシステムと連携させることで、Datadog ソリューションを既存のワークフローやプロセスに統合できます。Jira および ServiceNow インテグレーションを使用すると、Datadog のフルスタックテレメトリを使用してワークアイテムを解決しながら、これらのサードパーティシステムに記録を残すことができます。
通知
新しいワークアイテムが作成されたときに通知を受け取るには、ビューを作成します。
- 通知を受け取りたいプロジェクトに移動します。
- まだプロジェクトのメンバーでない場合は、Join This Project をクリックします。
- Add view をクリックします。
- Name フィールドにビューの名前を入力します。
- 検索ボックスに、通知を受け取りたいワークアイテムを取得するためのフィルタリングクエリを入力します。
- 受信者フィールドで通知方法を選択してください。
- Save をクリックします。
Notifications オプション
| インテグレーション | 構成 |
|---|
| メール | 1 つ以上のメールアドレスを選択してください。 |
| Slack | Slack のワークスペースとチャンネルを選択してください。 |
| Microsoft Teams | Microsoft Teams のテナントを Datadog に接続している場合は、テナント、チーム、チャンネルを選択してください。それ以外の場合は、コネクタを選択してください。 |
| PagerDuty | サービスを選択してください。 |
| Webhooks | Webhook の名前を選択してください。 |
Notifications ルール
プロジェクト設定で Notifications ルールを構成すると、重要な作業項目の更新に関するアラートを受け取ることができます。Notifications ルールを作成するには、
- Project Settings に移動し、プロジェクトをクリックして設定を展開してください。
- 展開されたメニューで、Notifications をクリックしてください。
- + Create Ruleをクリックして、Notifications ルールを追加してください。
- クエリフィールドにフィルターを入力して、Notifications のスコープを特定の作業項目に設定してください。たとえば、以下のとおりです。
priority:P1 OR priority:P2
- 通知を送信する条件を選択してください。以下から 1 つ以上を選択できます。
- 作業項目の作成
- ステータスの遷移
- 優先度の変更
- 担当者の変更
- 新しいアラートの相関 (イベント作業項目用)
- Notifications 先を選択します。サポートされている Notifications 先は以下の通りです。
- Email
- Slack
- Microsoft Teams
- PagerDuty
- Webhook
- Save をクリックしてルールを有効にします。
On-Call Paging ルール
ワークアイテムから、Datadog On-Call を使用してユーザーを手動または自動で呼び出すことができます。
手動でページをトリガーするには、
- ワークアイテムの詳細を開いてください。
- Page ボタンをクリックしてください。
自動的にページをトリガーするには、プロジェクト設定で自動ページングルールを構成してください。
- Project Settings に移動し、プロジェクトをクリックして設定を展開してください。
- 展開されたメニューで、Integrations > Datadog On-Call をクリックしてください。
- Automatically page work items to On-Call をオンに切り替えてください。これにより Paging Rule モーダルが開き、最初のルールを定義できます。
- モーダルでクエリを入力してください。ワークアイテムがライフサイクルのいずれかの時点で指定されたクエリに一致すると、Datadog は指定されたチームを自動的に呼び出します。
- 呼び出すチームを選択してください。
- Specific Team: ルールがトリガーされたときに常に呼び出される特定のチームを選択してください。
- Dynamic Team Selection:
Team属性を通じてワークアイテムに関連付けられたチームを自動的に呼び出してください。
- Add Rule をクリックします。
- Datadog On-Call 設定ページでルールを表示します。このページに戻ってこの構成を管理するか、New Paging Rule をクリックして複数のルールを追加します。
- (オプション) ページがトリガーされたときに、ワークアイテムをオンコールユーザーに自動的に割り当てる機能をオンに切り替えてください。
サードパーティのチケット
プロジェクト設定では、メンバーシップの管理、ワークアイテムの自動クローズの構成、および Jira や ServiceNow などのサードパーティインテグレーションのセットアップを行うことができます。
- Jira インテグレーションが構成されていることを確認します。
- Work Management プロジェクト設定で、プロジェクトから手動で Jira の課題を作成するために Jira を有効にします。
- Jira アカウント、課題を作成するプロジェクト、および希望する課題タイプ (ストーリー、エピック、バグ、タスクなど) を選択します。
- プロジェクトで作成された各ワークアイテムについて、Jira 課題を自動的に作成するよう選択できます。
- 以下の属性 (ワークアイテムのタイトル、説明、担当者、コメント、ステータス、優先度) について、以下のいずれかのオプションを選択します。
| オプション | 説明 |
|---|
| Once to Jira at work item creation | フィールドは、ワークアイテムの作成時にのみ Work Management から Jira に同期されます。その後の変更は、どちら側にも反映されません。 |
| Two-way sync (bi-directional) | Work Management での変更は Jira に反映され、その逆も同様です。 |
| Don’t sync | フィールドは Jira に同期されません。 |
- ワークアイテムのステータスと優先度について、Jira 側でマッピングする値を選択してください。
- 変更を保存します。
注:
ワークアイテムは、プロジェクトごとに一度に 1 つの外部リソースとのみ同期できます。Jira 同期を有効にするには、ServiceNow の自動作成と同期を無効にする必要があります。
[Open]、[In Progress]、[Closed] のコアステータスを使用しているワークアイテムのみが Jira と同期できます。
双方向同期には Webhook サポート が必要です。
課題の作成は、Jira Cloud および Data Center で利用できます。フィールド同期は Jira Cloud でのみ利用できます。
- ITOM および ITSM セットアップ手順 に従って ServiceNow インテグレーションを構成します。
- Work Management プロジェクト設定で、プロジェクトから手動で ServiceNow インシデントを作成するために ServiceNow を有効にします。
- ServiceNow インスタンスと割り当てグループを選択します。
- プロジェクトで作成された各ワークアイテムについて、ServiceNow インシデントを自動的に作成するよう選択できます。
- 以下の属性 (ステータス、コメント) について、以下のオプションのいずれかを選択します。
| オプション | 説明 |
|---|
| Once to ServiceNow at work item creation | フィールドは、ワークアイテムの作成時にのみ Work Management から ServiceNow に同期されます。その後の変更は、どちら側にも反映されません。 |
| All updates to ServiceNow | Work Management での変更は ServiceNow に反映されますが、ServiceNow での変更は Work Management には反映されません。 |
| Two-way sync (bi-directional) | Work Management での変更は ServiceNow に反映され、その逆も同様です。 |
| Don’t sync | フィールドは ServiceNow に同期されません。 |
- Work Management のステータス値をマッピングする ServiceNow のステート値を選択します。
- 変更を保存します。
注: 1 つのプロジェクトにつき、ワークアイテムは一度に 1 つの外部リソースとのみ同期できます。ServiceNow 同期を有効にするには、Jira の自動作成と同期を無効にする必要があります。[Open]、[In Progress]、[Closed] のコアステータスを使用しているワークアイテムのみが ServiceNow と同期できます。
- Linear インテグレーション が構成されていることを確認します。
- Work Management プロジェクト設定で、プロジェクトから手動で Linear の課題を作成するために Linear を有効にします。
- 課題を作成する Linear ワークスペースとチームを選択します。
- プロジェクトで作成されたワークアイテムごとに Linear 課題の自動作成を選択できます。
- 以下の属性 (ワークアイテムのタイトル、説明、担当者、コメント、ステータス、優先度) について、以下のいずれかのオプションを選択します。
| オプション | 説明 |
|---|
| Once to Linear at work item creation | フィールドは、ワークアイテムが作成された時点でのみ Work Management から Linear に同期されます。その後の変更は、どちら側にも反映されません。 |
| Two-way sync (bi-directional) | Work Management での変更は Linear に反映され、その逆も同様です。 |
| Don’t sync | フィールドは Linear に同期しません。 |
- ワークアイテムのステータスについて、Linear 側でどの状態にマッピングするかを選択します。
- 変更を保存します。
注:
インシデントの自動エスカレーション
イベント量が多いときに手動でインシデントを宣言すると、遅延が発生し、重要な状況下でのリスク露出が増大する可能性があります。Work Management からのインシデントの自動エスカレーションにより、ワークアイテムが定義した基準に一致したときにインシデントを自動的に宣言できるため、手動介入の必要がなくなります。
Project Settings page に移動し、Integrations > Datadog Incidents をクリックして、Auto-escalate work items to Incidents をオンに切り替えます。
有効にすると、指定したクエリ基準を満たすワークアイテム (ライフサイクルのどの時点であっても) が自動的にインシデントをトリガーし、チームの対応時間を短縮できます。
Slack ミラーリング
Slack インテグレーションを使用すると、ワークアイテムにリンクされた Slack 通知スレッドでの返信が、ワークアイテムのアクティビティタイムラインに自動的にミラーリングされます。これにより、Datadog で手動更新を行う必要なく、ワークアイテムのコンテキストを最新の状態に保つことができます。ワークアイテムへの Slack スレッドのミラーリングは、以下でサポートされています。
Slack スレッドのミラーリングを構成するには、
Datadog 組織に対して Slack インテグレーション が構成されていることを確認してください。
Slack スレッドのミラーリングは、すべての Work Management プロジェクトでデフォルトで有効になっています。特定のプロジェクトで無効にするには、
- Project Settings に移動し、プロジェクトをクリックして設定を展開します。
- 展開されたメニューで、Integrations > Slack をクリックします。
- Slack thread mirroring をオフに切り替えます。
仕組み
- Slack に送信されたワークアイテムの通知について、通知スレッド内のアクティビティがワークアイテムにミラーリングされます。
- ミラーリングされるアクティビティには、すべてのテキスト返信が含まれます (添付ファイルはサポートされていません)。ミラーリングされた各メッセージには、Slack ユーザーの名前と、ソースとして Slack が表示されます。
- 複数の Slack スレッドから単一のワークアイテムにコメントをミラーリングできます。
- ミラーリングは一方向です。メッセージは Slack からワークアイテムへ流れますが、ワークアイテムから Slack へは流れません。
参考資料
