当社のREST APIは、New RelicのオリジナルAPIで、New Relicのアラート設定をプログラムで設定します(当社の優先APIであるNerdGraphの詳細をご覧ください)。
REST APIエクスプローラーには、使用可能なAPIコールごとにcurlリクエストフォーマット、使用可能なパラメーター、取りうるレスポンス状態コード、JSONレスポンス構造も含まれます。UIでもアラート条件を作成できます。
REST APIを使用する前に
REST APIを使用してアラートデータを管理する前に、アラートと応用インテリジェンスのAPIの概要をお読みください。
Infrastructureのアラートについては、InfrastructureモニタリングアラートのREST APIを参照してください。
REST APIで使用可能なデータと機能
REST API関数 | コメント |
---|---|
アカウントデータを表示 | 一般的に、どのロールでもユーザーキーまたはREST APIキーとGET > List機能を使用して、アラートデータを表示できます。アカウントの所有者 (オーナー)と管理者は、自身のAPI キーを使用できます。 リストの出力にはページ番号が付けられることに注意してください。使用可能な機能:
|
アカウントデータのメンテナンス | POST > Create、PUT > Add、PUT > Update、DELETEを含むメンテナンス機能を使用するには、アカウントの所有者 (オーナー) またはAdminロールおよびユーザーキーを使用するか、またはアラートを管理するためのアクセス許可を付与するカスタムロールおよび**ユーザーキー**が必要になります。 |
REST APIから除外される条件
以下の条件には、APIで使用可能なエンドポイントはありません。
- APM:ウェブトランザクションパーセンタイル、条件ターゲティングラベル、ベースライン
- NRQL:ベースライン
アラートポリシー
これらのAPI関数には、ポリシーを簡単に作成、削除、リストすることができるAPIエクスプローラーへのリンクが含まれます。
重要
お使いのアカウントがEUデータセンターでデータをホストする場合は、適切なEU地域アカウント向けAPIエンドポイントを使用していることを確認してください。
新しいポリシーを追加するには、ユーザーキーを使用して、APIコールに以下の2つの値を含めます。
必須の値 | 定義 |
---|---|
インシデント | アラートがインシデントを作成し、違反をグループ化する方法を決めます。以下のいずれかの方法で行う必要があります。 |
ポリシー |
API Explorer: Alerts Policies > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_policies.json' \
-H 'X-Api-Key:$API_KEY' -i \
-H 'Content-Type: application/json' \
-d \
'{
"policy": {
"incident_preference": "string",
"name": "string"
}
}'
このAPIを使用して、既存のポリシーのname
とincident_preference
を更新します。ユーザーキーが必要になります。
必須の値 | 定義 |
---|---|
| 必須。ポリシーのIDを確認するには、以下のオプションのいずれかを使用します。
|
インシデント | アラートがインシデントを作成し、違反をグループ化する方法を決めます。以下のいずれかの方法で行う必要があります。 |
必須。名前を変更しない場合は、stringというポリシーにデフォルト設定されます。 List policies APIを使用して、ポリシーの正確な名前を確認します。 |
API Explorer: Alerts Policies > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_policies/{id}.json' \
-H 'X-Api-Key:$API_KEY' -i \
-H 'Content-Type: application/json' \
-d \
'{
"policy": {
"incident_preference": "string",
"name": "string"
}
}'
既存のポリシーを削除するには、ユーザーキーを使用して、policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)をAPIコールに含めます。
API Explorer: Alerts Policies > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_policies/$POLICY_ID.json' \
-H 'X-Api-Key:$API_KEY' -i
アカウントの既存ポリシーのリストを表示するには、ユーザーキーを使用して以下のオプションの値をAPIコールに含めます。
オプションのポリシー
name
フィルターオプションのページ番号付けの値
API Explorer: Alerts Policies > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \ -H 'X-Api-Key:$API_KEY' -i
通知チャネル
このAPI関数には、アラートの通知チャネルを作成、削除、リストアップできるAPIエクスプローラーへのリンクが含まれます。
重要
アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
新しい通知チャネルを追加するには、ユーザーキーを使用して以下の値をAPIコールに含めます。
新しいチャネルの名前
設定値
APIエクスプローラーには、通知チャネルのタイプごとに必要な設定値のフォーマットが表示されます。
API Explorer: Alerts Channels > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_channels.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "channel": { "name": "string", "type": "string", "configuration": "hash" } }'
この例の
"hash"
プレースホルダは、適切な値が置換された次のJSONブロックの1つと置き換える必要があります:{"recipients" : "test@google.com","include_json_attachment" : true}{"api_key": "abc123","teams": "team1","tags": "tag1","recipients": "me@me.com"}{"url": "http://example.com","channel": "channel1"}{"key": "mykey","route_key": "theroute"}{"service_key": "myservicekey"}この例では、デフォルトの
payload
を挿入しています。(payload
属性は任意です。)payload
は、表示しているキーと異なるキーを持つようにカスタマイズでき、$
のプレフィックスが付いた属性は配信の前に補完されて送信されます。重要
condition_id
は非推奨です。代わりに、condition_family_id
を使用してください。{"base_url": "http://example.com","auth_username": "username","auth_password": "password","payload_type": "application/json","headers": {"header1": "test","header2": "test"}"payload": {"account_id": "$ACCOUNT_ID","account_name": "$ACCOUNT_NAME","closed_violations_count_critical": "$CLOSED_VIOLATIONS_COUNT_CRITICAL","closed_violations_count_warning": "$CLOSED_VIOLATIONS_COUNT_WARNING","condition_family_id": "$CONDITION_FAMILY_ID","condition_id": "$CONDITION_ID","condition_name": "$CONDITION_NAME","current_state": "$EVENT_STATE","details": "$EVENT_DETAILS","duration": "$DURATION","event_type": "$EVENT_TYPE","incident_acknowledge_url": "$INCIDENT_ACKNOWLEDGE_URL","incident_id": "$INCIDENT_ID","incident_url": "$INCIDENT_URL","open_violations_count_critical": "$OPEN_VIOLATIONS_COUNT_CRITICAL","open_violations_count_warning": "$OPEN_VIOLATIONS_COUNT_WARNING","owner": "$EVENT_OWNER","policy_name": "$POLICY_NAME","policy_url": "$POLICY_URL","runbook_url": "$RUNBOOK_URL","severity": "$SEVERITY","targets": "$TARGETS","timestamp": "$TIMESTAMP","violation_callback_url": "$VIOLATION_CALLBACK_URL","violation_chart_url": "$VIOLATION_CHART_URL"}}この例では、デフォルトの
payload
を挿入しています。(payload
属性は任意です。)payload
は、表示しているキーと異なるキーを持つようにカスタマイズでき、$
のプレフィックスが付いた属性は配信の前に補完されて送信されます。重要
condition_id
は非推奨です。代わりに、condition_family_id
を使用してください。{"base_url": "http://example.com","auth_username": "username","auth_password": "password","payload_type": "application/x-www-form-urlencoded","headers": {"header1": "test","header2": "test"},"payload": {"account_id": "$ACCOUNT_ID","account_name": "$ACCOUNT_NAME","closed_violations_count_critical": "$CLOSED_VIOLATIONS_COUNT_CRITICAL","closed_violations_count_warning": "$CLOSED_VIOLATIONS_COUNT_WARNING","condition_family_id": "$CONDITION_FAMILY_ID","condition_id": "$CONDITION_ID","condition_name": "$CONDITION_NAME","current_state": "$EVENT_STATE","details": "$EVENT_DETAILS","duration": "$DURATION","event_type": "$EVENT_TYPE","incident_acknowledge_url": "$INCIDENT_ACKNOWLEDGE_URL","incident_id": "$INCIDENT_ID","incident_url": "$INCIDENT_URL","open_violations_count_critical": "$OPEN_VIOLATIONS_COUNT_CRITICAL","open_violations_count_warning": "$OPEN_VIOLATIONS_COUNT_WARNING","owner": "$EVENT_OWNER","policy_name": "$POLICY_NAME","policy_url": "$POLICY_URL","runbook_url": "$RUNBOOK_URL","severity": "$SEVERITY","targets": "$TARGETS","timestamp": "$TIMESTAMP","violation_callback_url": "$VIOLATION_CALLBACK_URL","violation_chart_url": "$VIOLATION_CHART_URL"}}
既存の通知チャネルを削除するには、ユーザーキーを使用して、channel_id
(API Explorer: Alerts Channels > GET > Listから取得可能)をAPIコールに含めます。
API Explorer: Alerts Channels > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_channels/{channel_id}.json' \
-H 'X-Api-Key:$API_KEY' -i
アカウントの既存の通知チャネルのリストを表示するには、ユーザーキーと、APIコールのオプションのページネーション値を使用します。
API Explorer: Alerts Channels > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_channels.json' \
-H 'X-Api-Key:$API_KEY' -i
New Relics Alertsでは、1つ以上の通知チャネルにポリシーを関連付けることができます。また、通知チャネルを1つ以上のポリシーに関連付けることもできます。ポリシーに通知チャネルを追加するには、ユーザーキーを使用して以下の値をAPIコールに含めます。
policy_id
値(API Explorer: Alerts Policies > GET > Listから入手可能)カンマまたは改行で区切られた配列内の1つ以上の
channel_id
値(API Explorer: Alerts Channels > GET > Listから入手可能)API Explorer: Alerts Policy Channels > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_policy_channels.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -G -d 'policy_id=$POLICY_ID&channel_ids=channel_id'
New Relics Alertsでは、1つ以上の通知チャネルにポリシーを関連付けることができます。また、通知チャネルを1つ以上のアラートポリシーに関連付けることもできます。
チャネルからポリシーを削除するか、またはポリシーからチャネルを削除するには、ユーザーキー、およびAPIコールの以下の値を使用します。
policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)channel_id
(API Explorer: Alerts Channels > GET > Listから入手可能)API Explorer: Alerts Policy Channels > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_policy_channels.json' \ -H 'X-Api-Key:$API_KEY' -i \ -d 'channel_id=CHANNEL_ID&policy_id=POLICY_ID'
APM、ブラウザ、モバイルの条件
このAPI関数には、ポリシーの条件を簡単に作成、更新、削除、リストできるAPIエクスプローラーへのリンクが含まれます。こうしたコールは、以下のタイプのエンティティ向け条件となります:
- APM:アプリとキートランザクション
- Browser:アプリとキートランザクション
- Mobile:モバイルアプリ
例外:次のAPMの条件は、このAPIエンドポイントからは入手できません。
- 条件ターゲティングラベル(ダイナミックターゲティング)
- ウェブトランザクションのパーセンタイル条件
- ベースライン条件
重要
APIエクスプローラーは、外部サービス(APMおよびモバイル)、Syntheticモニタリングを含む、別々のエンドポイントを使用して他のタイプの条件に関する情報を提供します。検索または更新中にすべてのタイプのアラート条件を考慮します。アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
ポリシーに条件を追加するには、以下の値をAPIコールに含めます:
policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)APIコールで必須とされる
condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Conditions > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_conditions/policies/$POLICY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "condition": { "type": "string", "name": "string", "enabled": boolean, "entities": [ integer ], "metric": "string", "gc_metric": "string", "condition_scope": "string", "violation_close_timer": integer, "runbook_url": "string", "terms": [ { "duration": "string", "operator": "string", "priority": "string", "threshold": "string", "time_function": "string" } ], "user_defined": { "metric": "string", "value_function": "string" } } }'
JSONレスポンスは、条件の更新や削除に必要な条件
id
を返します。条件id
をAPI Explorer: Alerts Conditions > GET > Listから表示することもできます。
ポリシーの条件を更新するには、以下の値をAPIコールに含めます:
条件の
id
(API Explorer: Alerts Conditions > GET > Listから入手可能)APIコールで必須とされる
condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Conditions > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "condition": { "type": "string", "name": "string", "enabled": boolean, "entities": [ integer ], "metric": "string", "metric": "string", "gc_metric": "string", "condition_scope": "string", "violation_close_timer": integer, "runbook_url": "string", "terms": [ { "duration": "string", "operator": "string", "priority": "string", "threshold": "string", "time_function": "string" } ], "user_defined": { "metric": "string", "value_function": "string" } } }'
ポリシーから条件を削除するには、以下の値をAPIコールに含めます:
condition_id
(API Explorer: Alerts Conditions > GET > Listから入手可能)API Explorer: Alerts Conditions > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i
ご利用のポリシーについて既存条件の一覧を表示するには、REST APIキーまたはユーザーキー、およびAPIコールの関連policy_id
を使用します。
API Explorer: Alerts Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json?policy_id=$POLICY_ID' \
-H 'X-Api-Key:$API_KEY' -i
NRQLの条件
このAPI関数には、ポリシーのNRQL条件を簡単に作成、更新、削除、リストできるAPIエクスプローラーへのリンクが含まれます。
例外:NRQLベースラインの条件は、このエンドポイントからは入手できません。
重要
アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
推奨事項:NRQLデータのストリーミング方法に応じて、aggregation_method
をEVENT_FLOW
に設定し、aggregation_window
には60
、aggregation_delay
には120
のデフォルト設定を使用します。EVENT_FLOW
はほとんどの使用例で機能しますが、どの使用例がEVENT_TIMER
でより適切に機能するかについては、どの集計方法を使用するかを参照してください。
API Explorer: Alerts Nrql Conditions > POST > Create
ポリシーのNRQL条件を作成する:
curl -X POST 'https://api.newrelic.com/v2/alerts_nrql_conditions/policies/$POLICY_ID.json' \
-H 'X-Api-Key:$API_KEY' -i \
-H 'Content-Type: application/json' \
-d \
'{
"nrql_condition": {
"type": "string",
"name": "string",
"runbook_url": "string",
"enabled": boolean,
"terms": [
{
"duration": "string",
"operator": "string",
"priority": "string",
"threshold": "string",
"time_function": "string"
}
],
"value_function": "string",
"nrql": {
"query": "string"
},
"signal": {
"aggregation_window": "string",
"slide_by": "integer",
"aggregation_method": "string",
"aggregation_delay": integer,
"aggregation_timer": integer,
"fill_option": "string",
"fill_value": "string"
},
"expiration": {
"expiration_duration": "string",
"open_violation_on_expiration": boolean,
"close_violations_on_expiration": boolean
}
}
}'
type
を除外するかstatic
と設定すると、標準的なNRQLアラートにデフォルト設定されます。
ポリシーのNRQL条件を更新するには、以下の値をAPIコールに含めます:
条件の
id
(API Explorer: Alerts Nrql Conditions > GET > Listから入手可能)APIコールで必須とされる
condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Nrql Conditions > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "nrql_condition": { "name": "string", "runbook_url": "string", "enabled": boolean, "terms": [ { "duration": "string", "operator": "string", "priority": "string", "threshold": "string", "time_function": "string" } ], "value_function": "string", "nrql": { "query": "string" } } }'
ポリシーからNRQL条件を削除するには、以下の値をAPIコールに含めます:
条件の
id
(API Explorer: Alerts Nrql Conditions > GET > Listから入手可能)API Explorer: Alerts Nrql Conditions > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i
ご利用のアラートポリシーについて既存条件の一覧を表示するには、REST APIキー、およびAPIコールの関連policy_id
を使用します。
API Explorer: Alerts Nrql Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_nrql_conditions.json' \
-H 'X-Api-Key:$API_KEY' -i \
-d 'policy_id=$POLICY_ID'
外部サービスの条件
このAPI関数には、ポリシーの条件を簡単に作成、更新、削除、リストできるAPIエクスプローラーへのリンクが含まれます。以下のコールは外部サービスの条件です。APIコールは、APMやモバイルモニタリングアプリと共に使用できます。
重要
アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
APMまたはモバイルモニタリングアプリを有するポリシーの外部サービスに条件を追加するには、以下の値をAPIコールに含めます:
policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)APIコールで必須とされる
external_service_condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts External Service Conditions > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_external_service_conditions/policies/$POLICY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "external_service_condition": { "type": "string", "name": "string", "enabled": boolean, "entities": [ integer ], "external_service_url": "string", "metric": "string", "runbook_url": "string", "terms": [ { "duration": "string", "operator": "string", "priority": "string", "threshold": "string", "time_function": "string" } ] } }'
JSONレスポンスは、条件の更新や削除に必要な条件
id
を返します。条件id
をAPI Explorer: Alerts External Service Conditions > GET > Listから表示することもできます。
APMまたはモバイルモニタリングアプリを有するポリシーの外部サービスの条件を更新するには、以下の値をAPIコールに含めます:
外部サービス条件の
id
(API Explorer: Alerts External Service Conditions > GET > Listから入手可能)APIコールで必須とされる
external_service_condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts External Service Conditions > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "external_service_condition": { "type": "string", "name": "string", "enabled": boolean, "entities": [ integer ], "external_service_url": "string", "metric": "string", "runbook_url": "string", "terms": [ { "duration": "string", "operator": "string", "priority": "string", "threshold": "string", "time_function": "string" } ] } }'
APMまたはモバイルモニタリングアプリを有するポリシーの外部サービスの条件を削除するには、以下の値をAPIコールに含めます:
condition_id
(API Explorer: Alerts External Service Conditions > GET > Listから入手可能)API Explorer: Alerts External Service Conditions > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i
外部サービスアプリ(APMまたはモバイルモニタリング)を持つポリシーの既存条件の一覧を表示するには、ユーザーキーまたはREST APIキー、およびAPIコールの関連policy_id
を使用します。
API Explorer: Alerts External Service Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_external_service_conditions.json' \
-H 'X-Api-Key:$API_KEY' -i \
-d 'policy_id=$POLICY_ID'
合成モニタリングの条件
以下のAPI関数には、アラートポリシーの条件を簡単に作成、更新、削除、リストできるAPIエクスプローラーへのリンクが含まれます。APIコールは、合成モニタリングと共に使用できます。
合成モニタリングのポリシーに条件を追加するには、以下の値をAPIコールに含めます:
policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)APIコールで必須とされる
synthetics_condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Synthetics Conditions > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_synthetics_conditions/policies/$POLICY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "synthetics_condition": { "name": "string", "monitor_id": "string", "runbook_url": "string", "enabled": boolean } }'
JSONレスポンスは、条件の更新や削除に必要な条件
id
を返します。条件id
をAPI Explorer: Alerts Synthetics Conditions > GET > Listから表示することもできます。
合成モニタリングのポリシーの条件を更新するには、以下の値をAPIコールに含めます:
条件
id
(API Explorer: Alerts Synthetics Conditions > GET > Listから入手可能)APIコールで必須とされる
synthetics_condition
値(synthetics用のアラート条件の作成のためのAPIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Synthetics Conditions > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_synthetics_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "synthetics_condition": { "name": "string", "monitor_id": "string", "runbook_url": "string", "enabled": boolean } }'
合成モニタリングのポリシーの条件を削除するには、以下の値をAPIコールに含めます:
condition_id
(API Explorer: Alerts Synthetics Conditions > GET > Listから入手可能)API Explorer: Alerts Synthetics Conditions > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_synthetics_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i
合成モニタリングの既存のポリシー条件一覧を表示するには、ユーザーキーまたはREST APIキー、およびAPIコールの関連policy_id
を使用します。
API Explorer: Alerts Synthetics Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_synthetics_conditions.json' \
-H 'X-Api-Key:$API_KEY' -i \
-d 'policy_id=$POLICY_ID'
複数の場所における合成モニタリングの条件
以下のAPI関数には、アラートポリシーの条件を簡単に作成、更新、削除、リストできるAPIエクスプローラーへのリンクが含まれます。APIコールは、合成モニタリングを使用して複数場所の条件に使用できます。条件を作成または更新する前に、複数場所のアラート条件のルールをお読みください。
複数の場所における合成モニタリングのポリシーに条件を追加するには、以下の値をAPIコールに含めます:
policy_id
(API Explorer: Alerts Policies > GET > Listから入手可能)APIコールで必須とされる
location_failure_condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Location Failure Conditions > POST > Create
curl -X POST 'https://api.newrelic.com/v2/alerts_location_failure_conditions/policies/$POLICY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "location_failure_condition": { "name": "string", "runbook_url": "string", "enabled": boolean, "entities": [ "string" ], "terms": [ { "priority": "string", "threshold": integer, } ], "violation_time_limit_seconds": integer } }'
JSONレスポンスは、条件の更新や削除に必要な条件
id
を返します。条件id
をAPI Explorer: Alerts Location Failure Conditions > GET > Listから表示することもできます。
複数の場所における合成モニタリングのポリシーの条件を更新するには、以下の値をAPIコールに含めます:
条件
id
(API Explorer: Alerts Location Failure Conditions > GET > Listから入手可能)APIコールで必須とされる
location_failure_condition
値(APIエクスプローラーページとアラート条件のAPI用語集で説明されています)API Explorer: Alerts Location Failure Conditions > PUT > Update
curl -X PUT 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -d \ '{ "location_failure_condition": { "name": "string", "runbook_url": "string", "enabled": boolean, "entities": [ "string" ], "terms": [ { "priority": "string", "threshold": integer, } ], "violation_time_limit_seconds": integer } }'
複数の場所における合成モニタリングのポリシーの条件を削除するには、以下の値をAPIコールに含めます:
condition_id
(API Explorer: Alerts Location Failure Conditions > GET > Listから入手可能)API Explorer: Alerts Location Failure Conditions > DELETE > Delete
curl -X DELETE 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \ -H 'X-Api-Key:$API_KEY' -i
複数の場所における合成モニタリングの既存のポリシー条件一覧を表示するには、ユーザーキーまたはREST APIキー、およびAPIコールの関連policy_id
を使用します。
API Explorer: Alerts Location Failure Conditions > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_location_failure_conditions.json' \
-H 'X-Api-Key:$API_KEY' -i \
-d 'policy_id=$POLICY_ID'
アラートアクティビティイベント、違反、インシデント
こうしたAPI関数には、アラートポリシーのイベント、違反、インシデントに関する情報を表示できるAPIエクスプローラーへのリンクが含まれます。
重要
アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
APM、ブラウザ、モバイル、Syntheticモニタリング、アラートが監視するエンティティのイベントを表示するには、以下の値をAPIコールに含めます:
フィルターとして使用するその他のオプションの値(APIエクスプローラーページに記載)は、製品のタイプ(ブラウザモニタリング、モバイルモニタリングなど)、エンティティ(APMのアプリやキートランザクション、Syntheticsのモニタリングなど)、イベントのタイプ(通知、デプロイメント、インストゥルメンテーションなど)によって異なります。
オプションのページネーション値
API Explorer: Alerts Events > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_events.json' \ -H 'X-Api-Key:$API_KEY' -i
アカウントについて監視するエンティティの違反を表示するには、以下の値をAPIコールに含めます:
現在オープンの違反のみを表示するオプションのフラグ
オプションのページネーション値
API Explorer: Alerts Violations > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_violations.json' \ -H 'X-Api-Key:$API_KEY' -i
ヒント
ポリシー、条件、およびインシデント情報を見つけるには:
violations
プロパティのlinks
セクションにあるIDを取得し、それらをペイロードの外部links
プロパティに含まれるURLに配置します。
アカウントについて監視するエンティティのインシデントを表示するには、以下の値をAPIコールに含めます:
現在オープンのインシデントのみを表示するオプションのフラグ
応答から違反データを除外するオプションのフラグ
オプションのページネーション値
API Explorer: Alerts Incidents > GET > List
curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json' \ -H 'X-Api-Key:$API_KEY' -i
アカウントに関連付けられた単一のインシデントを表示するには、以下の値をAPIコールに含めます:
インシデントID
API Explorer: Alerts Incidents > GET > Show
curl -X GET 'https://api.newrelic.com/v2/alerts_incidents/{id}.json' \ -H 'X-Api-Key:$API_KEY' -i
アカウントに関連付けられたインシデントを認識するには、以下の値をAPIコールに含めます:
インシデントID
API Explorer: Alerts Incidents > PUT > Acknowledge
curl -X PUT 'https://api.newrelic.com/v2/alerts_incidents/{id}/acknowledge.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json'
アカウントに関連付けられたインシデントをクローズするには、以下の値をAPIコールに含めます:
インシデントID
API Explorer: Alerts Incidents > PUT > Close
curl -X PUT 'https://api.newrelic.com/v2/alerts_incidents/{id}/close.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json'
アラートエンティティ条件
こうしたAPI関数には、アラートポリシーに対する条件のエンティティをリスト、追加、削除できるAPIエクスプローラーへのリンクが含まれます。
重要
アカウントがEUデータセンターでデータをホストする場合は、適切なEUリージョンアカウント向けAPIエンドポイントを使用していることを確認してください。
APM、ブラウザ、モバイル、キートランザクションにおいて、エンティティに適用される条件を表示するには、以下の値をAPIコールに含めます:
entity_id
は監視対象の特定のエンティティ(アラートターゲット)です。entity_type
は、次のいずれかである必要があります:- アプリケーション
- ブラウザアプリケーション
- モバイルアプリケーション
- キートランザクション
API Explorer: Alerts Entity Conditions > GET > list
curl -X GET 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -G -d 'entity_type=$ENTITY_TYPE'
条件にエンティティを追加するには、以下の値をAPIコールに含めます:
entity_id
は監視対象のエンティティ(アラートターゲット)です。APMアプリケーション、ブラウザアプリ、キートランザクション、モバイルアプリの数値IDです。condition_id
(API Explorer: Alerts Conditions > GET > Listから入手可能)entity_type
は、次のいずれかである必要があります:- アプリケーション
- ブラウザアプリケーション
- モバイルアプリケーション
- キートランザクション
API Explorer: Alerts Entity Conditions > PUT > Add
curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -H 'Content-Type: application/json' \ -G -d 'entity_type=$ENTITY_TYPE&condition_id=$CONDITION_ID'
監視しているエンティティを条件から削除するには、以下の値をAPIコールに含めます:
entity_id
は削除されることになる特定の監視対象エンティティ(アラートターゲット)です。APMアプリケーション、ブラウザアプリ、キートランザクション、モバイルアプリの数値IDです。condition_id
(API Explorer: Alerts Conditions > GET > Listから入手可能)entity_type
は、次のいずれかである必要があります:- アプリケーション
- ブラウザアプリケーション
- モバイルアプリケーション
- キートランザクション
API Explorer: Alerts Entity Conditions > DELETE > Remove
curl -X DELETE 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \ -H 'X-Api-Key:$API_KEY' -i \ -G -d 'entity_type=$ENTITY_ID&condition_id=$CONDITION_ID'