アラート状態でのエンティティの管理

アラートでは、entity は、アプリケーション、 browser 、ホストなど、監視の対象となる任意のオブジェクトとして定義されます。 アラート UI には、選択可能なエンティティが表示されます。 REST API と API Explorer を使用して、条件のエンティティを追加または削除することもできます。

RESTAPIを使用する前に

REST API は、アラートをプログラムで管理するための推奨方法ではなくなりました。 詳細については、 アラートの API の概要をお読みください。

要件

条件のエンティティのリストを変更するには、知っておく必要があります。

• あなたの API キー
• {entity_ID}です。 モニタリングしたいエンティティの
• {condition_ID}を表示します。修正したい条件の

一般的な手順

ある条件のエンティティリストを更新するには

1. 適切な エンティティ ID を探します。例えば、 アプリケーション ID や ブラウザ ID などです。

2. ポリシーIDを名前またはタイプで特定する.

3. ポリシーに関連する条件のリストを取得し、該当するカテゴリーの中から変更したいものを選択します。

   • APM

     、

     ブラウザ監視

     、および

     モバイル監視

   • 外部サービス

   • 合成モニタリング

4. add または remove のAPIリクエストを使用して条件を変更します。

例エンティティの追加・削除

次の例は、条件にTimberTimeという名前のRubyアプリケーションを追加する方法と、同じ条件からエンティティを削除する方法を示しています。

この例では、最初のステップだけが、エンティティとしてRubyアプリを選択した場合に固有のものとなっています。残りのステップは、どのエンティティを選択しても同じです。

1. entity_idを取得します;たとえば、 {application_id} ：

   curl -X GET 'https://api.newrelic.com/v2/applications.json' \
        -H "X-Api-Key:$API_KEY" -i

   コピー

   また

   アプリケーション名がわかっている場合は、このコマンドを使用してapp_nameを指定します。

   curl -X GET 'https://api.newrelic.com/v2/applications.json' \
        -H "X-Api-Key:$API_KEY" -i \
        -d 'filter[name]=TimberTime'

   コピー

2. 出力を確認して{application_id}を見つけ、それを{entity_id}として使用します。

   {
     "applications": [
       {
         "id": 12345,    <---<<<  {application_id} == {entity_id}
         "name": "TimberTime",
         "language": "ruby",
         "health_status": "gray",
         ...
       },

   コピー

3. 更新するpolicy_idを取得します。たとえば、 TimberTimeアプリのLogjam Alertポリシー。 policy_idを取得するには、次のコマンドを使用します。

   curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
        -H "X-Api-Key:$API_KEY" -i \
        -G -d 'filter[name]= Logjam Alert'    <---<<<  {policy_name}

   コピー

4. ポリシーの出力を確認します。

   {
     "policies": [
       {
         "id": 85,      <---<<<  {policy_id}
         "incident_preference": "PER_POLICY",
         "name": "Logjam Alert",
         "created_at": 1461176510393,
         "updated_at": 1461176510393
       },

   コピー

5. このポリシーのすべての条件をリストし、 {condition_id}を見つけます。

   curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json' \
        -H "X-Api-Key:$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"
           }
         ]
       }
     ]
   }

   コピー

6. APIリクエストを使用して、ポリシーの条件にエンティティを追加したり、ポリシーの条件からエンティティを削除したりします。

   {entity_id}を{condition_id} 234567に追加するには、 {entity_type}をapplicationに設定します。

   curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/12345.json' \
        -H "X-Api-Key:$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を削除するには：

   curl -X DELETE 'https://api.newrelic.com/v2/alerts_entity_conditions/8288171.json' \
        -H "X-Api-Key:$API_KEY" -i \
        -G -d 'entity_type=Application&condition_id=234567'

   コピー