アラーム履歴の確認

アラーム履歴一覧取得のAPIを実行して、対象のアラームのアクションの実行状態を確認します。

形式例


curl -s -H "X-Auth-Token: ..." "https://telemetry.jp-east-1.cloud.global.fujitsu.com/v2/alarms/「アラームID」/history?q.field=timestamp&q.op=ge&q.value=「YYYY-MM-DDThh%3Amm%3Ass」&q.field=timestamp&q.op=lt&q.value=「YYYY-MM-DDThh%3Amm%3Ass」"       
     
  • 「アラームID」に対象のアラームのIDを指定してください。
  • 「YYYY-MM-DDThh%3Amm%3A ss」に該当の日時を指定してください。
    • YYYY:年、MM:月、DD:日、hh:時、mm:分、ss:秒を表します。上記の前半は開始日時、後半は終了日時の指定になります(開始日時≦timestamp<終了日時)。確認する時間帯を指定してください(UTCで指定してください)。
    • 「%3A」は「:」をエンコードした値になります。そのまま指定してください。
  • パラメーターの詳細については、「アラーム履歴一覧取得(GET /v2/alarms/{alarm_id}/history)」を参照してください。

Example of Request

以下に実行例を示します(アラームIDが「2a5d914d-ac5c-474d-8550-58098f668a66」、日時の範囲に「2015/07/18 00:00:00~01:00:00(UTC)」を指定してアラーム履歴を取得)。


curl -s -H "X-Auth-Token: ..." "https://telemetry.jp-east-1.cloud.global.
fujitsu.com/v2/alarms/2a5d914d-ac5c-474d-8550-58098f668a66/history?q.field=
timestamp&q.op=ge&q.value=2015-07-18T00%3A00%3A00&q.field=timestamp&q.op=
lt&q.value=2015-07-18T01%3A00%3A00"       
     

Example of Response


[
    {
        "alarm_id": "2a5d914d-ac5c-474d-8550-58098f668a66",
        "detail": "{\"notification_resource\": \"\", \"region\": 
\"jp-east-1\", \"action_state\": \"Succeeded\", \"reason\": \"Remaining as 
alarm due to 1 samples outside threshold, most recent: 0.0\", \"error\": \"
\", \"action\": \"http://orchestration-cfn.jp-east-1.internal.cloud.global.
fujitsu.com/v1/signal/arn%3Aopenstack%3Aheat%3A%3Acd1e2866ebda406bb16b81960
22e2692%3Astacks%2Faz1_test_stack_vm3%2F548ae98a-a0bc-43bd-aff5-a4146f78358
5%2Fresources%2Fscalein_policy?Timestamp=2015-07-17T05%3A34%3A21Z&Signature
Method=HmacSHA256&AWSAccessKeyId=cab5efa3009b4f00817b354b0744601e&Signature
Version=2&Signature=FKLe2NApryuVZUCybV%2F%2Ffmd21xw%2BYApUSridiKE5M%2FE
%3D\", \"alarm\": {\"alarm_actions\": [\"http://orchestration-cfn.jp-east-1.
internal.cloud.global.fujitsu.com/v1/signal/arn%3Aopenstack%3Aheat%3A
%3Acd1e2866ebda406bb16b8196022e2692%3Astacks%2Faz1_test_stack_vm3%2F548ae98
a-a0bc-43bd-aff5-a4146f783585%2Fresources%2Fscalein_policy?Timestamp=2015-
07-17T05%3A34%3A21Z&SignatureMethod=HmacSHA256&AWSAccessKeyId=
cab5efa3009b4f00817b354b0744601e&SignatureVersion=2&Signature=
FKLe2NApryuVZUCybV%2F%2Ffmd21xw%2BYApUSridiKE5M%2FE%3D\"], \"ok_actions\":
[], \"description\": \"Scale-in if the average CPU < 15% for 1 minutes\",
\"state \": \"alarm\", \"timestamp\": \"2015-07-17T05:34:28.674867\", 
\"enabled\": true, \"state_timestamp\": \"2015-07-17T05:35:52.188434\", 
\"rule\": {\"meter_name\": \"fcx.compute.cpu_util\", \"evaluation_
periods\": 1,\"period\": 60, \"statistic\": \"avg\", \"threshold\": 15.0,
\"query\": [{\"field\": \"metadata.user_metadata.groupname\", \"value\":
\"az1_test_stack_vm3-auto_scaling_group- h5ve5jiy5pbf\", \"op\": \"eq\"},
{\"field\":\"project_id\", \"value\": \"c52b2f54d96a4c28ba9a318eae9c843c\",
\"op\": \"eq\"}],  \"comparison_operator\": \"lt\", \"exclude_outliers\":
false}, \"alarm_id\": \"2a5d914d-ac5c-474d-8550-58098f668a66\", \"time_
constraints \": [], \"insufficient_data_actions\": [], \"repeat_actions\":
true, \"user_id\": \"2cc0568f5daf4ac694a49f3b32a42dfc\", \"project_id\":  
\"c52b2f54d96a4c28ba9a318eae9c843c\", \"type\": \"threshold\", \"name\":
\"az1_test_stack_vm3-scalein_alarm-fzps2blpsiql \"}, \"previous\": \"alarm\"}",
        "event_id": "02c06d0e-f78d-463c-a775-c63b337e771d",
        "on_behalf_of": "c52b2f54d96a4c28ba9a318eae9c843c",
        "project_id": "c52b2f54d96a4c28ba9a318eae9c843c",
        "timestamp": "2015-07-18T00:01:00.182820",
        "type": "action",
        "user_id": "2cc0568f5daf4ac694a49f3b32a42dfc"
    },
    ...
]       
     
  • 「type」の値が「action」になっているものはアクションの実行履歴を表します。
  • 「action」の履歴が存在する場合は、「detail」の値の中の「action_state」の値を確認してください。
    • 「action_state」が「Succeeded」になっている場合は、アクション実行は成功しています。
    • 「action_state」が「Failed」になっている場合は、アクションは実行されましたが、エラーになっています。「detail」の値の中の「error」や「error_message」の値を確認し、「アクション実行時のエラーについて」を参照して対処を行ってください。
    • 「action」の履歴が存在しない場合はアクションの実行は行われていません。以降の手順を実施してアラームのしきい値超過が発生しているかどうかを確認してください。