では、entity はアプリケーション、 browser 、ホストなどの監視対象として定義されます。 アラート UI には、選択可能なエンティティが表示されます。 REST API と API Explorer を使用して、条件のエンティティを追加または削除することもできます。
RESTAPIを使用する前に
REST API は、アラートをプログラムで管理するための推奨方法ではなくなりました。 詳細については、 「アラートの API の概要」をお読みください。
要件
条件のエンティティのリストを変更するには、知っておく必要があります。
- あなたの API キー
- 監視するエンティティの{'{entity_ID}'}
- 変更したい条件の{'{condition_ID}'}
一般的な手順
ある条件のエンティティリストを更新するには
適切なエンティティ ID を見つけます。たとえば、アプリケーション IDやbrowser ID などです。
ポリシーに関連する条件のリストを取得し、該当するカテゴリーの中から変更したいものを選択します。
追加または削除API リクエストを使用して条件を変更します。
例: エンティティの追加または削除
次の例は、条件にTimberTime
という名前のRubyアプリケーションを追加する方法と、同じ条件からエンティティを削除する方法を示しています。
この例では、最初のステップだけが、エンティティとしてRubyアプリを選択した場合に固有のものとなっています。残りのステップは、どのエンティティを選択しても同じです。
entity_id
を取得します;たとえば、application_id
:bash$curl -X GET 'https://api.newrelic.com/v2/applications.json' \>-H $API_KEY -iまた
アプリケーション名がわかっている場合は、このコマンドを使用して
app_name
を指定します。bash$curl -X GET 'https://api.newrelic.com/v2/applications.json' \>-H $API_KEY -i \>-d 'filter[name]=TimberTime'出力を確認して
application_id
を見つけ、それをentity_id
として使用します。{"applications": [{"id": 12345, // application_id == entity_id"name": "TimberTime","language": "ruby","health_status": "gray",...},更新する
policy_id
を取得します。たとえば、TimberTime
アプリのLogjam Alert
ポリシー。policy_id
を取得するには、次のコマンドを使用します。bash$curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \>-H $API_KEY -i \>-G -d 'filter[name]= Logjam Alert' # policy_nameポリシーの出力を確認します。
{"policies": [{"id": 85, // policy_id"incident_preference": "PER_POLICY","name": "Logjam Alert","created_at": 1461176510393,"updated_at": 1461176510393},このポリシーのすべての条件をリストし、
condition_id
を見つけます。bash$curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json' \>-H $API_KEY -i \>-G -d 'policy_id=85'契約条件の見直し、例えば
{"conditions": [{"id": 234567, // condition_id"type": "apm_app_metric","name": "Throughput (web) (High)","enabled": true,"entities": ["8288171" // Entity currently included in the policy],"metric": "response_time_web","terms": [{"duration": "5","operator": "above","priority": "critical","threshold": "500","time_function": "all"}]}]}APIリクエストを使用して、ポリシーの条件にエンティティを追加したり、ポリシーの条件からエンティティを削除したりします。
entity_id
をcondition_id
234567に追加するには、entity_type
をApplication
に設定します。bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/12345.json' \>-H $API_KEY -i \>-H 'Content-Type: application/json' \>-G -d 'entity_type=Application&condition_id=234567'entity_type
をApplication
に設定してcondition_id
}234567からentity_id
8288171を削除するには:bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_entity_conditions/8288171.json' \>-H $API_KEY -i \>-G -d 'entity_type=Application&condition_id=234567'