» Data Source: oci_monitoring_alarm_history_collection

This data source provides details about a specific Alarm History Collection resource in Oracle Cloud Infrastructure Monitoring service.

Get the history of the specified alarm.

» Example Usage 

data "oci_monitoring_alarm_history_collection" "test_alarm_history_collection" {
    #Required
    alarm_id = "${oci_monitoring_alarm.test_alarm.id}"

    #Optional
    alarm_historytype = "${var.alarm_history_collection_alarm_historytype}"
    timestamp_greater_than_or_equal_to = "${var.alarm_history_collection_timestamp_greater_than_or_equal_to}"
    timestamp_less_than = "${var.alarm_history_collection_timestamp_less_than}"
}

» Argument Reference

The following arguments are supported:

  • alarm_historytype - (Optional) The type of history entries to retrieve. State history (STATE_HISTORY) or state transition history (STATE_TRANSITION_HISTORY). If not specified, entries of both types are retrieved. Example: STATE_HISTORY
  • alarm_id - (Required) The OCID of an alarm.
  • timestamp_greater_than_or_equal_to - (Optional) A filter to return only alarm history entries with timestamps occurring on or after the specified date and time. Format defined by RFC3339. Example: 2019-01-01T01:00:00.789Z
  • timestamp_less_than - (Optional) A filter to return only alarm history entries with timestamps occurring before the specified date and time. Format defined by RFC3339. Example: 2019-01-02T01:00:00.789Z

» Attributes Reference

The following attributes are exported:

  • alarm_id - The OCID of the alarm for which to retrieve history.

  • entries - The set of history entries retrieved for the alarm.

    • summary - Description for this alarm history entry. Avoid entering confidential information.

      Example 1 - alarm state history entry: The alarm state is FIRING

      Example 2 - alarm state transition history entry: State transitioned from OK to Firing

    • timestamp - Timestamp for this alarm history entry. Format defined by RFC3339. Example: 2019-02-01T01:02:29.600Z

    • timestamp_triggered - Timestamp for the transition of the alarm state. For example, the time when the alarm transitioned from OK to Firing. Available for state transition entries only. Note: A three-minute lag for this value accounts for any late-arriving metrics. Example: 2019-02-01T0:59:00.789Z

  • is_enabled - Whether the alarm is enabled. Example: true