監視インフラストラクチャを設定したら、クエリを使用して合成エンティティに関する情報を取得できます。モニター、プライベートロケーション、認証情報、ダウンタイムに関するデータを取得するrequestsを行います。 このチュートリアルでは、NerdGraph API使用して外形監視データを作成する方法の例を示します。
ヒント
Quick Navigation:以下のリンクを使用して、特定のクエリタイプにジャンプしてください:
- 一般的なモニタークエリ:すべてのモニターまたは特定のタイプをクエリします
- モニター固有のクエリ: スクリプト化されたモニターからスクリプトを、またはステップモニターから順序付けられたステップを取得します
- エンティティクエリのサポート: プライベートロケーション、セキュアな認証情報をクエリし、ダウンタイムをモニターします
- 高度なクエリ: レガシーモニターIDをマッピングし、ランタイムのアップグレードステータスを確認する
合成エンティティで使用できる追加のクエリ機能については、 NerdGraph エンティティ API チュートリアルをご覧ください。
一般的なモニタークエリ
この文章は、アカウント内のすべての合成モニターを取得し、モニターの GUID、名前、アカウント ID、モニター タイプ、関連タグなどの重要な情報を返します。 タグには、各モニターに関する追加の設定の詳細とメタデータが含まれます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。すべての合成モニターを取得するには、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR'") { results { entities { ... on SyntheticMonitorEntityOutline { guid name accountId monitorType tags { key values } } } } } }}エンティティサポートクエリ
この文章は、アカウント内のすべてのプライベートな場所を取得し、場所の GUID、名前、アカウント ID、関連するタグなどの重要な情報を返します。 ロケーションを使用すると、ファイアウォールの背後にあるプライベート アプリケーションを監視でき、その設定の詳細にはタグからアクセスできます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。すべてのプライベート位置を取得するには、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'PRIVATE_LOCATION'") { results { entities { accountId guid name tags { key values } } } } }}この文章は、アカウント内のすべてのモニター ダウンタイムを取得し、ダウンタイムの GUID、名前、アカウント ID、関連タグなどの重要な情報を返します。 モニター ダウンタイムは、合成モニターの実行が停止するスケジュールされた期間であり、計画されたメンテナンスや既知の停止時に役立ちます。 スケジュールの種類、タイムゾーン、繰り返しパターンなどの設定内容はタグに保存されます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。すべてのモニターのダウンタイムを取得するには、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR_DOWNTIME'") { results { entities { accountId guid name tags { key values } } } } }}このクエリは、アカウント内のすべてのセキュリティ保護された資格情報を取得し、資格情報の GUID、名前、アカウント ID、タグ、最終更新タイムスタンプなどのメタデータ情報を返します。安全な資格情報は、パスワード、 APIキー、エンコードされた証明書などの機密情報を保存、保護、集中管理するのに役立ちます。 セキュリティ上の理由から、安全な資格情報を照会すると、実際の資格情報の値そのものではなく、メタデータのみが返されます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。すべての安全な資格情報を取得するには、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'SECURE_CRED'") { results { entities { ... on SecureCredentialEntityOutline { accountId guid name tags { key values } updatedAt } } } } }}モニター固有のクエリ
このクエリは、スクリプト化APIまたはスクリプト化ブラウザモニターで使用されるスクリプトの内容を取得します。スクリプトには、APIコール、ブラウザのインタラクション、またはカスタム検証ロジックなど、モニターの動作を定義するJavaScriptコードが含まれています。このクエリはスクリプト化されたモニタータイプでのみ機能します:他のモニタータイプ(シンプル、ping、ステップ、証明書チェック、リンク切れ)はカスタムスクリプトを使用しないため、エラーを返します。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
(アカウント) | 整数 | はい | モニターを含む New Relic アカウント ID。 |
| 弦 | はい | 取得するスクリプトが含まれるスクリプト モニターの一意のエンティティ GUID。 |
サンプルクエリ
{ actor { account(id: ACCOUNT_ID) { synthetics { script(monitorGuid: "ENTITY_GUID") { text } } } }}このクエリは、ステップモニターに設定されたステップを取得します。ステップモニターは、ナビゲーション、クリック、フォーム入力、アサーションなどの事前定義された一連のアクションを通じて、コードレスでマルチステップのブラウザベースの監視を提供します。各ステップには、順序位置、アクションを定義するタイプ、およびステップの設定データを含む値があります。このクエリはステップモニターでのみ動作します:他のモニタータイプはステップベースの設定を使用しないため、エラーを返します。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
(アカウント) | 整数 | はい | モニターを含む New Relic アカウント ID。 |
| 弦 | はい | 取得するステップのステップ モニターの一意のエンティティ GUID。 |
サンプルクエリ
{ actor { account(id: ACCOUNT_ID) { synthetics { steps(monitorGuid: "ENTITY_GUID") { ordinal type values } } } }}高度なクエリ
このクエリは、モニター ID を使用して合成モニターのエンティティ GUID を取得します。これは、レガシーの数値モニター ID を持っていて、それをほとんどの NerdGraph 操作に必要なエンティティ GUID 形式に変換する必要がある場合に便利です。 エンティティ GUID は、更新、削除、その他のモニター管理タスクに使用される最新の識別子であり、モニター ID は、URL またはレガシー統合に表示される古い数値識別子です。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | モニターを見つけるための検索クエリ。検索したいモニターの数値IDが
である場合、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "(domainId = 'MONITOR_ID')") { results { entities { ... on SyntheticMonitorEntityOutline { guid name monitorId } } } } }}このクエリは、アカウント内のレガシー ランタイム モニターのすべてのランタイム アップグレード テストのステータスを取得します。これらのテストでは、古いランタイム (Chrome 72 や Node.js API レガシーなど) を使用するモニターが新しいランタイム (Chrome 100+ または Node.js 16.10) で正常に実行できるかどうかを検証します。結果はランタイム アップグレード UIに表示され、アップグレードの準備ができているモニターを識別するのに役立ちます。テスト結果はvalidationStatusタグに保存され、アップグレード テストが失敗した場合は、詳細なエラー情報がvalidationErrorタグに表示されます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。すべてのランタイム アップグレード テスト結果を取得するには、
を使用します。 |
サンプルクエリ
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION'") { results { entities { accountId guid name tags { key values } } } } }}このクエリは、モニター ID を使用して、特定のレガシー ランタイム モニターのランタイム アップグレード テストのステータスを取得します。これは、アカウント内のすべてのモニターではなく、特定のモニターのアップグレードの準備状況を確認する場合に便利です。 このテストでは、モニターが新しいランタイムで正常に実行できるかどうかを検証し、その結果をランタイム アップグレード UIに入力します。テスト結果はvalidationStatusタグに保存され、アップグレード テストが失敗した場合は、詳細なエラー情報がvalidationErrorタグに表示されます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | エンティティをフィルタリングするための検索クエリ。
が特定のモニターの数値IDである場合は、
を使用します。 |
サンプルクエリ
{ actor { entitySearch( query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION' AND domainId = 'MONITOR_ID'" ) { results { entities { accountId guid name tags { key values } } } } }}