アラートについてのREST 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を更新します。ユーザーキーが必要になります。

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エクスプローラーには、通知チャネルのタイプごとに必要な設定値のフォーマットが表示されます。

  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
  }

  コピー

  OpsGenieチャネル

  {
    "api_key": "abc123",
    "teams": "team1",
    "tags": "tag1",
    "recipients": "me@me.com"
  }

  コピー

  Slackチャネル

  {
    "url": "http://example.com",
    "channel": "channel1"
  }

  コピー

  VictorOpsチャネル

  {
    "key": "mykey",
    "route_key": "theroute"
  }

  コピー

  PagerDutyチャネル

  {
    "service_key": "myservicekey"
  }

  コピー

  Webhook （json） チャネル

  この例では、デフォルトの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"
    }
  }

  コピー

  Webhook （x-www-form-urlencoded）チャネル

  この例では、デフォルトの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'

  コピー

ポリシーに条件を追加するには、以下の値を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データのストリーミング方法に応じて、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'

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コールに含めます：

• ユーザーキー

• 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コールに含めます：

• ユーザーキー

• 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'

APM、ブラウザ、モバイル、Syntheticモニタリング、アラートが監視するエンティティのイベントを表示するには、以下の値をAPIコールに含めます：

• ユーザーキーまたはREST 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コールに含めます：

• ユーザーキーまたはREST 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コールに含めます：

• ユーザーキーまたはREST 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コールに含めます：

• ユーザーキーまたはREST 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'

  コピー

APM、ブラウザ、モバイル、キートランザクションにおいて、エンティティに適用される条件を表示するには、以下の値をAPIコールに含めます：

• ユーザーキーまたはREST 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'

  コピー