REST Resource: projects.locations.instances.errorNotificationConfigs

Resource: ErrorNotificationConfig

ErrorNotificationConfig provides ability for customers to configure and receive self serve notifications. An ErrorNotificationConfig will contain a single notification type eg. IngestionCountZeroNotifications. An notification type can have multiple notification conditions to be set for the error notification. Each NotificationCondition will have its own params such as filters (Eg: CollectorID + logType combo). Please refer below link for more https://cloud.google.com/chronicle/docs/reference/ingestion-metrics-schema CollectorID can also come from forwarders configurations as well. Please refer link for more details: https://cloud.google.com/chronicle/docs/install/forwarder-linux#sample_configuration

JSON representation
{
  "name": string,
  "displayName": string,
  "enabled": boolean,
  "notificationChannels": [
    string
  ],

  // Union field notification_type can be only one of the following:
  "ingestionCountZeroNotifications": {
    object (IngestionCountZeroNotifications)
  },
  "ingestionSizeThresholdNotifications": {
    object (IngestionSizeThresholdNotifications)
  },
  "normalizationDelayThresholdNotifications": {
    object (NormalizationDelayThresholdNotifications)
  }
  // End of list of possible types for union field notification_type.
}
Fields
name

string

Required if the error notification config exists. The resource name for this error notification config. The format is: projects/{project}/locations/{location}/instances/{instance}/errorNotificationConfigs/{ERROR_NOTIFICATION_CONFIG_ID}

displayName

string

A short name used to identify the error notification config.

enabled

boolean

Used to enable/disable error notification config

notificationChannels[]

string

Identifies the notification channels to which notifications should be sent when incidents are opened or closed or when new violations occur. Format: projects/{PROJECT_ID}/notificationChannels/{CHANNEL_ID} More at: https://cloud.google.com/monitoring/support/notification-options

Union field notification_type. Notification type for the error notification config. notification_type can be only one of the following:
ingestionCountZeroNotifications

object (IngestionCountZeroNotifications)

Notifications set for ingestion outages caused by metrics absence.

ingestionSizeThresholdNotifications

object (IngestionSizeThresholdNotifications)

Notifications set for ingestion outages caused by metrics not meeting threshold.

normalizationDelayThresholdNotifications

object (NormalizationDelayThresholdNotifications)

Notifications set for normalization delays using threshold type trigger.

IngestionCountZeroNotifications

Notifications set for ingestion outages caused by metrics absence.

JSON representation
{
  "notificationConditions": [
    {
      object (NotificationConditionIngestionCountZero)
    }
  ]
}
Fields
notificationConditions[]

object (NotificationConditionIngestionCountZero)

Notifications conditions present in the ErrorNotificationConfig.

NotificationConditionIngestionCountZero

Describes parameters for the notification condition.

JSON representation
{
  "collectorId": string,
  "logType": string,
  "missingDuration": string
}
Fields
collectorId

string

CollectorID for which the error notification is set.

logType

string

Log type for which the error notification is set.

missingDuration

string (Duration format)

Number of seconds with no data ingested. Currently, only values that are a multiple of a minute e.g., 0, 60, 120, or 300 seconds are supported.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

IngestionSizeThresholdNotifications

Notifications set for ingestion outages caused by metrics not meeting threshold.

JSON representation
{
  "notificationConditions": [
    {
      object (NotificationConditionIngestionSizeThreshold)
    }
  ]
}
Fields
notificationConditions[]

object (NotificationConditionIngestionSizeThreshold)

Notifications conditions present in the ErrorNotificationConfig.

NotificationConditionIngestionSizeThreshold

Describes parameters for the notification condition.

JSON representation
{
  "collectorId": string,
  "logType": string,
  "dataSize": number,
  "monitoredDuration": string,
  "comparisonType": enum (ComparisonType)
}
Fields
collectorId

string

CollectorID for which the error notification is set.

logType

string

log type for which the error notification is set.

dataSize

number

Amount of dataSize bytes in the last monitoredDuration seconds. The comparison is applied on the time series, with the time series on the left-hand side and the dataSize on the right-hand side.

monitoredDuration

string (Duration format)

Duration of the monitored window as explained above. Currently, only values that are a multiple of a minute e.g., 0, 60, 120, 300 seconds etc. are supported.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".

comparisonType

enum (ComparisonType)

Comparison type as explained above. Only COMPARISON_LT and COMPARISON_GT are supported currently.

ComparisonType

Specifies an ordering relationship on two arguments, called left and right.

Enums
COMPARISON_UNSPECIFIED No ordering relationship is specified.
COMPARISON_GT True if the left argument is greater than the right argument.
COMPARISON_GE True if the left argument is greater than or equal to the right argument.
COMPARISON_LT True if the left argument is less than the right argument.
COMPARISON_LE True if the left argument is less than or equal to the right argument.
COMPARISON_EQ True if the left argument is equal to the right argument.
COMPARISON_NE True if the left argument is not equal to the right argument.

NormalizationDelayThresholdNotifications

Notifications set for normalization delays using threshold type trigger.

JSON representation
{
  "notificationConditions": [
    {
      object (NotificationConditionNormalizationDelayThreshold)
    }
  ]
}
Fields
notificationConditions[]

object (NotificationConditionNormalizationDelayThreshold)

Notifications conditions present in the ErrorNotificationConfig.

NotificationConditionNormalizationDelayThreshold

Describes parameters for the notification condition.

JSON representation
{
  "logType": string,
  "threshold": number
}
Fields
logType

string

log type for which the error notification is set.

threshold

number

When the % of normalized events for a log type falls below a certain threshold.

Methods

create

Creates a new error notification config for the customer

delete

Deletes an error notification config.

get

Gets a single error notification config.

list

Lists error notification configurations for the customer.

patch

Updates an error notification config.