アクションフローでのNew Relicアクションの使い方

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

現在のプランを確認

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

要約：◀▼

APIキーを使用してアクションフローをNew Relicに接続することで、データクエリ、エンティティの参照や検索、アラート条件の作成を含むワークフローを自動化できます。安全なインテグレーションのため、専用のサービスアカウントを使用してください。このコネクションにより、NRQLクエリの実行、エンティティの詳細の取得、条件に基づくエンティティの検索、アラート条件の作成が可能になり、ワークフロー内で直接、システムの監視や管理を行うことができます。

アクションビルダーをNew Relicなどの外部システムに接続すると、管理者は自動化されたワークフロー内でZendeskと外部システムを連携させ、コラボレーションを強化し、複数のプラットフォームにわたってシームレスなエクスペリエンスを維持できます。

メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

• アクションビルダーをNew Relicに接続する
• アクションフローでのNew Relicアクションの使い方

アクションビルダーをNew Relicに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続してアクションフローで外部アクションを使用する場合は、以下のベストプラクティスをお勧めします。

• アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
• すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
• OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。

New RelicでユーザーAPIキーを作成するには

New Relicコネクションでは、APIキー認証が使用されます。New RelicアカウントのユーザーAPIキーを用意する必要があります。このキーは、データのクエリや設定の管理に使用されます。APIキーには、使用する予定のアクションに必要なNew Relic APIへアクセスできる適切な権限が必要です。

New Relic APIキーの詳細については、New Relicのドキュメントを参照してください。

重要：APIキーは安全に保管してください。他人と共有したり、バージョン管理システムにコミットしたりしないでください。本番環境のワークフローでは、専用のサービスアカウント用APIキーを使用してください。

1. New Relicのユーザーメニューに移動します。
2. 「APIキー」を選択します。
3. 新しいAPIキーを作成します。
4. APIキーを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。

   このキーは、アクションビルダーをNew Relicに接続する際に必要になります。

アクションビルダーをNew Relicに接続するには

1. 管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
2. アクションフローを新規作成するか、既存のアクションフローを編集します。
3. ステップサイドバーを開きます。
4. 「外部アクション」セクションで、「New Relic」をクリックします。
5. 「接続」をクリックします。
6. New Relicの画面の指示に従ってNew RelicのAPIキーを入力し、接続を完了します。
   重要：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細、およびNew Relicで利用可能なアクションが表示されます。

アクションフローでのNew Relicアクションの使い方

以下のNew Relicアクションを使用できます。

• データを照会
• エンティティを参照
• エンティティを検索
• アラート条件を作成

データを照会する

「データを照会」アクションを使用して、New Relicのテレメトリデータに対してNRQLクエリを実行します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Account ID、NRQL query 「Account ID」フィールドには、指定したAPIキーでアクセス可能なアカウントがドロップダウンに表示される。 「NRQL query」はSQLに似た構文を使用する。例：SELECT count(*) FROM Transaction WHERE appName='WebApp' SINCE 1 hour ago オプション：Timeout 「Timeout」フィールドに設定できる値は1～120秒（デフォルトは10秒）。
出力	クエリの結果：NRQLのSELECT句によって決まるフィールドを含む結果オブジェクトの配列、行数、および集計クエリの場合は結果の合計値。

エンティティを参照する

「エンティティを参照」アクションを使用して、モニタリング対象の特定のエンティティに関する詳細情報を取得します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Account ID、Entity 「Entity」フィールドは検索可能なドロップダウン。エンティティ名を2文字以上入力して検索する。検索結果にはエンティティ名とタイプが表示され、New Relic内のそのエンティティへのリンクも表示される。参照するエンティティを選択し、現在のアラートステータスや関連タグなどの詳細情報を取得する。
出力	エンティティの詳細情報：エンティティのGUID、名前、タイプ、URL、レポートステータス、アラートの重大度、メタデータを含むタグなど。

エンティティを検索する

「エンティティを検索」アクションを使用して、検索条件に一致するモニタリング対象のエンティティを検索します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Account ID オプション：Search query、Entity type、Alert severity、Tag filter、Max results 「エンティティを検索」アクションを使用する際の注意点： 検索フィルターはすべてオプションであり、組み合わせて使用可能。 「Search query」フィールドには、New Relicのエンティティ検索構文を使用する（例：name LIKE 'Web%'）。 「Entity type」は、利用可能なエンティティタイプのドロップダウン。「Alert severity」のオプションにはNOT_ALERTING、WARNING、CRITICAL がある。 「Tag filter」には「キー:値」形式を使用（例：環境:本番）。 「Max results」に設定できる値は1～200（デフォルトは50）。
出力	エンティティオブジェクトの配列：エンティティのGUID、名前、タイプ、URL、ドメイン、レポートステータス、アラートの重大度、タグ、総件数、およびさらに結果があるかどうかを示すインジケーター。

アラート条件を作成する

「アラート条件を作成」アクションを使用して、New Relicに新しいNRQLアラート条件を作成します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Account ID、Alert policy、Condition name、NRQL query、Critical threshold オプション：Warning threshold、Threshold duration、Threshold operator、Enabled 「アラート条件を作成」アクションを使用する際の注意点： 「Alert policy」フィールドは、選択したアカウントのポリシーを表示する、検索可能なドロップダウン。 しきい値を比較するために、NRQLクエリは1つの数値を返す必要がある（例：SELECT count(*) FROM ZendeskTicketCreated SINCE 1 hour ago）。 「Critical threshold」は、重大アラートをトリガする数値。 「Warning threshold」はオプションで、警告レベルのアラートをトリガするしきい値を指定する。 「Threshold duration」オプションは、しきい値の条件を満たしてからアラートが発行されるまでの時間を60～3600秒で指定する（デフォルトは300秒）。 「Threshold operator」のオプションは、「ABOVE」、「BELOW」、または「EQUALS」（デフォルトは「ABOVE」）。 「Enabled」オプションは、条件が直ちに有効になるかどうかを設定する（デフォルトは true）。
出力	アラート条件の詳細：条件ID、条件名、ポリシーID、有効状態など。