Herramienta: get_alert_policy
Usa esta herramienta como la principal para obtener información sobre una política de alertas específica. Las políticas de alertas definen las condiciones en las que deseas recibir notificaciones sobre problemas con tus servicios. Esto es útil para comprender los detalles de una configuración de alerta específica.
En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP get_alert_policy.
| Solicitud de Curl |
|---|
curl --location 'https://monitoring.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_alert_policy", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Es el protocolo para la solicitud de GetAlertPolicy.
GetAlertPolicyRequest
| Representación JSON |
|---|
{ "name": string } |
| Campos | |
|---|---|
name |
Obligatorio. Política de alertas que se recuperará. El formato es el siguiente: |
Esquema de salida
Una descripción de las condiciones según las cuales algún aspecto de tu sistema se considera "en mal estado" y las formas de notificar a las personas o servicios acerca de este estado. Para obtener una descripción general de las políticas de alertas, consulta Introducción a las alertas.
AlertPolicy
| Representación JSON |
|---|
{ "name": string, "displayName": string, "documentation": { object ( |
| Campos | |
|---|---|
name |
Es el identificador. Obligatorio si existe la política. Es el nombre del recurso de esta política. El formato es el siguiente: Cloud Monitoring asigna |
displayName |
Es un nombre corto o una frase que se usa para identificar la política en los paneles, las notificaciones y los incidentes. Para evitar confusiones, no uses el mismo nombre visible para varias políticas en el mismo proyecto. El nombre tiene un límite de 512 caracteres Unicode. La convención para el display_name de un PrometheusQueryLanguageCondition es "{nombre del grupo de reglas}/{nombre de la alerta}", en la que el {nombre del grupo de reglas} y el {nombre de la alerta} deben tomarse del archivo de configuración de Prometheus correspondiente. Esta convención no se aplica de forma obligatoria. En cualquier caso, display_name no es una clave única de AlertPolicy. |
documentation |
Documentación que se incluye con las notificaciones y los incidentes relacionados con esta política. La práctica recomendada es que la documentación incluya información para ayudar a los encargados de ofrecer respuestas a comprender, mitigar, derivar y corregir los problemas subyacentes detectados por la política de alertas. Es posible que los canales de notificación que tienen capacidad limitada no muestren esta documentación. |
userLabels |
Son los datos de clave/valor proporcionados por el usuario que se usarán para organizar e identificar los objetos El campo puede contener hasta 64 entradas. Cada clave y valor se limita a 63 caracteres Unicode o 128 bytes, lo que sea menor. Las etiquetas y los valores solo pueden contener letras en minúscula, números, guiones bajos y guiones. Las claves deben comenzar con una letra. Ten en cuenta que Prometheus {alert name} es un nombre de etiqueta de Prometheus válido, mientras que Prometheus {rule group} es una cadena UTF-8 sin restricciones. Esto significa que no se pueden almacenar tal como están en las etiquetas de usuario, ya que pueden contener caracteres que no se permiten en los valores de las etiquetas de usuario. Un objeto que contiene una lista de pares |
conditions[] |
Es una lista de condiciones de la política. Las condiciones se combinan con Y o O según el campo |
combiner |
Es la forma de combinar los resultados de varias condiciones para determinar si se debe abrir un incidente. Si |
enabled |
Indica si la política está habilitada o no. Cuando se escribe, la interpretación predeterminada si no se establece es que la política está habilitada. En la lectura, los clientes no deben hacer ninguna suposición sobre el estado si no se propagó. El campo siempre debe completarse en las operaciones de lista y obtención, a menos que se haya especificado una proyección de campo que lo quite. |
validity |
Es una descripción de solo lectura de por qué no es válida la política de alertas. Este campo solo se configura cuando la política de alertas no es válida. Una política de alertas no válida no generará incidentes. |
notificationChannels[] |
Identifica los canales de notificación a los que se deben enviar notificaciones cuando se abren o cierran incidentes, o cuando se producen incumplimientos nuevos en un incidente ya abierto. Cada elemento de este array corresponde al campo |
creationRecord |
Es un registro de solo lectura de la creación de la política de alertas. Si se proporciona en una llamada para crear o actualizar, este campo se ignorará. |
mutationRecord |
Es un registro de solo lectura del cambio más reciente en la política de alertas. Si se proporciona en una llamada para crear o actualizar, este campo se ignorará. |
alertStrategy |
Control sobre cómo se notifican los canales de notificación de esta política de alertas. |
severity |
Es opcional. La gravedad de una política de alertas indica la importancia de los incidentes que genera esa política. El nivel de gravedad se mostrará en la página Detalles del incidente y en las notificaciones. |
Documentación
| Representación JSON |
|---|
{
"content": string,
"mimeType": string,
"subject": string,
"links": [
{
object ( |
| Campos | |
|---|---|
content |
Cuerpo de la documentación, interpretado según |
mimeType |
Es el formato del campo |
subject |
Es opcional. Es el asunto de la notificación. La línea de asunto no puede superar los 10,240 bytes. En las notificaciones que genera esta política, el contenido de la línea de asunto después de la expansión de variables se truncará a 255 bytes o menos en el límite de caracteres UTF-8 más reciente. Este hilo recomienda el límite de 255 bytes. Es el límite que imponen algunos productos de venta de entradas de terceros y es común definir campos de texto en bases de datos como VARCHAR(255). El contenido del asunto se puede crear a partir de plantillas con variables. Si este campo falta o está vacío, se generará una línea de asunto predeterminada. |
links[] |
Es opcional. Vínculos a contenido, como guías, repositorios y otros recursos. Este campo puede contener hasta 3 entradas. |
Vínculo
| Representación JSON |
|---|
{ "displayName": string, "url": string } |
| Campos | |
|---|---|
displayName |
Es un nombre visible corto para el vínculo. El nombre visible no debe estar vacío ni superar los 63 caracteres. Ejemplo: "manual". |
url |
Es la URL de una página web. Se puede crear una plantilla de una URL usando variables en la ruta o en los parámetros de consulta. La longitud total de una URL no debe exceder los 2,083 caracteres antes ni después de la expansión de variables. Ejemplo: "https://my_domain.com/playbook?name=${resource.name}" |
UserLabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
Condición
| Representación JSON |
|---|
{ "name": string, "displayName": string, // Union field |
| Campos | |
|---|---|
name |
Obligatorio si existe la condición. Es el nombre único del recurso para esta condición. Su formato es el siguiente: Cloud Monitoring asigna Cuando llames al método Cuando llamas al método La práctica recomendada es conservar |
displayName |
Es un nombre corto o una frase breve que se usa para identificar la condición en los paneles, las notificaciones y los incidentes. Para evitar confusiones, no uses el mismo nombre visible para varias condiciones en la misma política. |
Campo de unión condition. Solo se especificará uno de los siguientes tipos de condiciones. condition puede ser solo uno de los parámetros siguientes: |
|
conditionThreshold |
Es una condición que compara una serie temporal con un umbral. |
conditionAbsent |
Es una condición que verifica que una serie temporal siga recibiendo datos nuevos. |
conditionMatchedLog |
Es una condición que verifica si hay mensajes de registro que coincidan con las restricciones proporcionadas. Si se configura, no puede haber otras condiciones. |
conditionMonitoringQueryLanguage |
Es una condición que usa el lenguaje de consultas de Monitoring para definir alertas. |
conditionPrometheusQueryLanguage |
Es una condición que usa el lenguaje de consulta de Prometheus para definir alertas. |
conditionSql |
Es una condición que evalúa periódicamente el resultado de una consulta en SQL. |
MetricThreshold
| Representación JSON |
|---|
{ "filter": string, "aggregations": [ { object ( |
| Campos | |
|---|---|
filter |
Obligatorio. Es un filtro que identifica qué series temporales se deben comparar con el umbral. El filtro es similar al que se especifica en la solicitud |
aggregations[] |
Especifica la alineación de los datos en series temporales individuales, así como la forma de combinar las series temporales recuperadas (por ejemplo, cuando se agregan varias transmisiones en cada recurso a una sola transmisión para cada recurso o cuando se agregan transmisiones en todos los miembros de un grupo de recursos). Las agregaciones múltiples se aplican en el orden especificado. Este campo es similar al de la solicitud |
denominatorFilter |
Un filtro que identifica una serie temporal que se debe usar como denominador de una proporción que se comparará con el umbral. Si se especifica un El filtro debe especificar el tipo de métrica y, de manera opcional, puede contener restricciones sobre el tipo de recurso, las etiquetas de recursos y las etiquetas de métricas. Este campo no puede superar los 2,048 caracteres Unicode de longitud. |
denominatorAggregations[] |
Especifica la alineación de los datos en las series temporales individuales seleccionadas por Cuando se calculan proporciones, los campos |
forecastOptions |
Cuando este campo está presente, la condición |
comparison |
Es la comparación que se aplicará entre las series temporales (indicadas por Actualmente, solo se admiten |
thresholdValue |
Es un valor con el que se comparará la serie temporal. |
duration |
Obligatorio. Es la cantidad de tiempo durante la que una serie temporal debe incumplir el límite para considerarse con fallas. Actualmente, solo se admiten valores que son múltiplos de un minuto, p.ej., 0, 60, 120 o 300 segundos. Si se proporciona un valor no válido, se mostrará un error. Cuando elijas una duración, es útil tener en cuenta la frecuencia de los datos subyacentes de la serie temporal (que también puede verse afectada por cualquier alineación especificada en el campo Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
trigger |
Es la cantidad o el porcentaje de series temporales para las que se debe mantener la comparación para que se active la condición. Si no se especifica, la condición se activará si la comparación es verdadera para cualquiera de las series temporales que se identificaron con |
evaluationMissingData |
Es un control de condición que determina cómo se evalúan las condiciones de umbral de métrica cuando dejan de llegar datos. Para usar este control, el valor del campo |
Agregación
| Representación JSON |
|---|
{ "alignmentPeriod": string, "perSeriesAligner": enum ( |
| Campos | |
|---|---|
alignmentPeriod |
El El valor debe ser de al menos 60 segundos. Si se especifica un alineador por serie que no sea El valor máximo de Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
perSeriesAligner |
Un Es posible que no todas las operaciones de alineación se puedan aplicar a todas las series temporales. Las opciones válidas dependen de los valores de Los datos de series temporales deben alinearse para realizar la reducción entre series temporales. Si se especifica |
crossSeriesReducer |
Operación de reducción que se usará para combinar series temporales en una sola, en la que el valor de cada dato de la serie resultante es una función de todos los valores ya alineados en las series temporales de entrada. No todas las operaciones de reducción se pueden aplicar a todas las series temporales. Las opciones válidas dependen de Los datos de series temporales primero deben alinearse (consulta |
groupByFields[] |
Es el conjunto de campos que se conservarán cuando se especifique |
Duración
| Representación JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campos | |
|---|---|
seconds |
Son los segundos firmados del período. Debe estar entre -315,576,000,000 y +315,576,000,000, inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/d * 365.25 d/a * 10,000 a |
nanos |
Fracciones firmadas de un segundo con una resolución de nanosegundos del período. Las duraciones inferiores a un segundo se representan con un campo |
ForecastOptions
| Representación JSON |
|---|
{ "forecastHorizon": string } |
| Campos | |
|---|---|
forecastHorizon |
Obligatorio. Es el período futuro para el que se prevé si una serie temporal incumplirá el umbral. Si se detecta que el valor predicho incumple el umbral y el incumplimiento se observa en todas las previsiones realizadas para el Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
Activador
| Representación JSON |
|---|
{ // Union field |
| Campos | |
|---|---|
Campo de unión type. Es un tipo de activador. type puede ser solo uno de los parámetros siguientes: |
|
count |
Es la cantidad absoluta de series temporales que deben fallar en el predicado para que se active la condición. |
percent |
Es el porcentaje de series temporales que deben fallar en el predicado para que se active la condición. |
MetricAbsence
| Representación JSON |
|---|
{ "filter": string, "aggregations": [ { object ( |
| Campos | |
|---|---|
filter |
Obligatorio. Es un filtro que identifica qué series temporales se deben comparar con el umbral. El filtro es similar al que se especifica en la solicitud |
aggregations[] |
Especifica la alineación de los datos en series temporales individuales, así como la forma de combinar las series temporales recuperadas (por ejemplo, cuando se agregan varias transmisiones en cada recurso a una sola transmisión para cada recurso o cuando se agregan transmisiones en todos los miembros de un grupo de recursos). Las agregaciones múltiples se aplican en el orden especificado. Este campo es similar al de la solicitud |
duration |
Obligatorio. Es la cantidad de tiempo durante la que una serie temporal debe dejar de informar datos nuevos para considerarse que falla. El valor mínimo de este campo es de 120 segundos. Se admiten valores más grandes que sean múltiplos de un minuto, por ejemplo, 240 o 300 segundos. Si se proporciona un valor no válido, se mostrará un error. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
trigger |
Es la cantidad o el porcentaje de series temporales para las que se debe mantener la comparación para que se active la condición. Si no se especifica, la condición se activará si la comparación es verdadera para cualquiera de las series temporales que se identificaron con |
LogMatch
| Representación JSON |
|---|
{ "filter": string, "labelExtractors": { string: string, ... } } |
| Campos | |
|---|---|
filter |
Obligatorio. Es un filtro basado en registros. Consulta Consultas de registros avanzadas para saber cómo se debe crear este filtro. |
labelExtractors |
Es opcional. Es un mapa de una clave de etiqueta a una expresión de extractor, que se usa para extraer el valor de esta clave de etiqueta. Cada entrada de este mapa es una especificación de cómo se deben extraer los datos de las entradas de registro que coinciden con Consulta la documentación sobre las métrica basada en registros Un objeto que contiene una lista de pares |
LabelExtractorsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
MonitoringQueryLanguageCondition
| Representación JSON |
|---|
{ "query": string, "duration": string, "trigger": { object ( |
| Campos | |
|---|---|
query |
Consulta del lenguaje de consultas de Monitoring que genera un flujo booleano. |
duration |
Es opcional. Es la cantidad de tiempo durante la que una serie temporal debe incumplir el límite para considerarse con fallas. Actualmente, solo se admiten valores que son múltiplos de un minuto, p.ej., 0, 60, 120 o 300 segundos. Si se proporciona un valor no válido, se mostrará un error. Cuando elijas una duración, es útil tener en cuenta la frecuencia de los datos subyacentes de la serie temporal (que también puede verse afectada por cualquier alineación especificada en el campo Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
trigger |
Es la cantidad o el porcentaje de series temporales para las que se debe mantener la comparación para que se active la condición. Si no se especifica, la condición se activará si la comparación es verdadera para cualquiera de las series temporales que se identificaron con |
evaluationMissingData |
Es un control de condición que determina cómo se evalúan las condiciones de umbral de métrica cuando dejan de llegar datos. |
PrometheusQueryLanguageCondition
| Representación JSON |
|---|
{ "query": string, "duration": string, "evaluationInterval": string, "labels": { string: string, ... }, "ruleGroup": string, "alertRule": string, "disableMetricValidation": boolean } |
| Campos | |
|---|---|
query |
Obligatorio. Es la expresión PromQL que se evaluará. En cada ciclo de evaluación, esta expresión se evalúa en el momento actual, y todas las series temporales resultantes se convierten en alertas pendientes o activadas. Este campo no puede estar vacío. |
duration |
Es opcional. Las alertas se consideran activadas una vez que la expresión de PromQL se evaluó como “verdadera” durante este período. Las alertas cuya expresión de PromQL no se evaluó como “verdadera” durante el tiempo suficiente se consideran pendientes. Debe ser una duración no negativa o faltar. Este campo es opcional. Su valor predeterminado es cero. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
evaluationInterval |
Es opcional. Con qué frecuencia se debe evaluar esta regla. Debe ser un múltiplo positivo de 30 segundos o no estar presente. Este campo es opcional. Su valor predeterminado es 30 segundos. Si este PrometheusQueryLanguageCondition se generó a partir de una regla de alerta de Prometheus, este valor se debe tomar del grupo de reglas adjunto. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
labels |
Es opcional. Son las etiquetas que se agregarán o reemplazarán en el resultado de la consulta de PromQL. Los nombres de las etiquetas deben ser válidos. Los valores de las etiquetas se pueden generar a partir de plantillas con variables. Los únicos nombres de variables disponibles son los nombres de las etiquetas en el resultado de PromQL, incluidos "__name__" y "value". "labels" puede estar vacío. Un objeto que contiene una lista de pares |
ruleGroup |
Es opcional. Es el nombre del grupo de reglas de esta alerta en el archivo de configuración de Prometheus correspondiente. Es posible que algunas herramientas externas requieran que este campo se complete correctamente para hacer referencia al archivo de configuración original de Prometheus. El nombre del grupo de reglas y el nombre de la alerta son necesarios para actualizar las AlertPolicies pertinentes en caso de que la definición del grupo de reglas cambie en el futuro. Este campo es opcional. Si este campo no está vacío, debe contener una cadena UTF-8 válida. Este campo no puede superar los 2,048 caracteres Unicode de longitud. |
alertRule |
Es opcional. Es el nombre de la regla de alerta de esta alerta en el archivo de configuración de Prometheus correspondiente. Es posible que algunas herramientas externas requieran que este campo se complete correctamente para hacer referencia al archivo de configuración original de Prometheus. El nombre del grupo de reglas y el nombre de la alerta son necesarios para actualizar las AlertPolicies pertinentes en caso de que la definición del grupo de reglas cambie en el futuro. Este campo es opcional. Si este campo no está vacío, debe ser un nombre de etiqueta de Prometheus válido. Este campo no puede superar los 2,048 caracteres Unicode de longitud. |
disableMetricValidation |
Es opcional. Indica si se debe inhabilitar la validación de la existencia de la métrica para esta condición. Esto permite definir políticas de alertas sobre métricas que aún no existen, lo que mejora los flujos de trabajo avanzados de los clientes, como la configuración de políticas de alertas con Terraform. Los usuarios con el rol de |
LabelsEntry
| Representación JSON |
|---|
{ "key": string, "value": string } |
| Campos | |
|---|---|
key |
|
value |
|
SqlCondition
| Representación JSON |
|---|
{ "query": string, // Union field |
| Campos | |
|---|---|
query |
Obligatorio. Es la consulta en SQL de Log Analytics que se ejecutará, como una cadena. La consulta debe cumplir con la forma requerida. Específicamente, la búsqueda no debe intentar filtrar la entrada por tiempo. Se aplicará automáticamente un filtro para filtrar la entrada, de modo que la consulta reciba todas las filas recibidas desde la última vez que se ejecutó. Por ejemplo, la siguiente consulta extrae todas las entradas de registro que contienen una solicitud HTTP: |
Campo de unión schedule. El programa indica la frecuencia con la que se debe ejecutar la consulta. schedule puede ser solo uno de los parámetros siguientes: |
|
minutes |
Programa la consulta para que se ejecute cada cierta cantidad de minutos. |
hourly |
Programa la consulta para que se ejecute cada cierta cantidad de horas. |
daily |
Programa la consulta para que se ejecute cada cierta cantidad de días. |
Campo de unión evaluate. Es la prueba que se ejecutará en el conjunto de resultados de SQL. evaluate puede ser solo uno de los parámetros siguientes: |
|
rowCountTest |
Comprueba el recuento de filas en relación con un umbral. |
booleanTest |
Prueba el valor booleano en la columna indicada. |
Minutos
| Representación JSON |
|---|
{ "periodicity": integer } |
| Campos | |
|---|---|
periodicity |
Obligatorio. Cantidad de minutos entre ejecuciones. El intervalo debe ser mayor o igual que 5 minutos y menor o igual que 1,440 minutos. |
Cada hora
| Representación JSON |
|---|
{ "periodicity": integer, // Union field |
| Campos | |
|---|---|
periodicity |
Obligatorio. Cantidad de horas entre ejecuciones. Debe ser mayor o igual que 1 hora y menor o igual que 48 horas. |
Campo de unión
|
|
minuteOffset |
Es opcional. Cantidad de minutos después de la hora (en UTC) para ejecutar la consulta. Debe ser mayor o igual que 0 minutos y menor o igual que 59 minutos. Si no se especifica, se usa un desplazamiento arbitrario. |
Diario
| Representación JSON |
|---|
{
"periodicity": integer,
"executionTime": {
object ( |
| Campos | |
|---|---|
periodicity |
Obligatorio. Cantidad de días entre ejecuciones. Debe ser mayor o igual a 1 día y menor o igual a 31 días. |
executionTime |
Es opcional. Hora del día (en UTC) en la que se debe ejecutar la consulta. Si no se especifica, el servidor elige una hora del día arbitraria y ejecuta la consulta a la misma hora todos los días. |
TimeOfDay
| Representación JSON |
|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
| Campos | |
|---|---|
hours |
Horas de un día en formato de 24 horas. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 23. Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas. |
minutes |
Minutos de una hora. Debe ser mayor o igual que 0 y menor o igual que 59. |
seconds |
Segundos de un minuto. Debe ser mayor o igual que 0 y, por lo general, debe ser menor o igual que 59. Una API puede permitir el valor 60 si permite segundos bisiestos. |
nanos |
Fracciones de segundos, en nanosegundos. Debe ser mayor o igual que 0 y menor o igual que 999,999,999. |
RowCountTest
| Representación JSON |
|---|
{
"comparison": enum ( |
| Campos | |
|---|---|
comparison |
Obligatorio. Es la comparación que se aplicará entre la cantidad de filas que devuelve la consulta y el umbral. |
threshold |
Obligatorio. Valor con el que se comparará el recuento de filas. |
BooleanTest
| Representación JSON |
|---|
{ "column": string } |
| Campos | |
|---|---|
column |
Obligatorio. Es el nombre de la columna que contiene el valor booleano. Si el valor de una fila es NULL, se ignora esa fila. |
BoolValue
| Representación JSON |
|---|
{ "value": boolean } |
| Campos | |
|---|---|
value |
Es el valor booleano. |
Estado
| Representación JSON |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| Campos | |
|---|---|
code |
El código de estado, que debe ser un valor enum de |
message |
Un mensaje de error dirigido al desarrollador, que debe estar en inglés. Cualquier mensaje de error dirigido al usuario debe localizarse y enviarse al campo |
details[] |
Una lista de mensajes que contienen los detalles del error. Hay un conjunto común de tipos de mensajes para que usen las API. Un objeto que contiene campos de un tipo arbitrario. Un campo adicional |
Cualquiera
| Representación JSON |
|---|
{ "typeUrl": string, "value": string } |
| Campos | |
|---|---|
typeUrl |
Identifica el tipo del mensaje serializado de Protobuf con una referencia de URI que consta de un prefijo que termina en una barra y el nombre de tipo completo. Ejemplo: type.googleapis.com/google.protobuf.StringValue Esta cadena debe contener al menos un carácter El prefijo es arbitrario, y se espera que las implementaciones de Protobuf simplemente quiten todo hasta el último Todas las cadenas de URL de tipo deben ser referencias URI legales con la restricción adicional (para el formato de texto) de que el contenido de la referencia solo debe constar de caracteres alfanuméricos, escapes codificados como porcentaje y caracteres del siguiente conjunto (sin incluir las comillas invertidas externas): En el diseño original de |
value |
Contiene una serialización de Protobuf del tipo que describe type_url. Es una cadena codificada en Base64. |
MutationRecord
| Representación JSON |
|---|
{ "mutateTime": string, "mutatedBy": string } |
| Campos | |
|---|---|
mutateTime |
Cuándo se produjo el cambio Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
mutatedBy |
La dirección de correo electrónico del usuario que realiza el cambio |
Marca de tiempo
| Representación JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Campos | |
|---|---|
seconds |
Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z). |
nanos |
Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive. |
AlertStrategy
| Representación JSON |
|---|
{ "notificationRateLimit": { object ( |
| Campos | |
|---|---|
notificationRateLimit |
Se requiere para las políticas de alertas basadas en registros, es decir, las políticas con una condición Este límite no se implementa para las políticas de alertas que no tienen una condición LogMatch. |
notificationPrompts[] |
En el caso de las políticas de alertas basadas en registros, el mensaje de notificación siempre es [OPENED]. En el caso de las políticas de alertas que no se basan en registros, los mensajes de notificación pueden ser [OPENED] o [OPENED, CLOSED]. |
autoClose |
Si una política de alertas que estaba activa no tiene datos durante este tiempo, se cerrarán todos los incidentes abiertos. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
notificationChannelStrategy[] |
Controla cómo se enviarán las notificaciones por canal. |
NotificationRateLimit
| Representación JSON |
|---|
{ "period": string } |
| Campos | |
|---|---|
period |
No más de una notificación por Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
NotificationChannelStrategy
| Representación JSON |
|---|
{ "notificationChannelNames": [ string ], "renotifyInterval": string } |
| Campos | |
|---|---|
notificationChannelNames[] |
Es el nombre completo del recurso de REST para los canales de notificación a los que se aplica esta configuración. Cada uno de estos elementos corresponde al campo name de uno de los objetos NotificationChannel a los que se hace referencia en el campo notification_channels de esta AlertPolicy. El formato es el siguiente: |
renotifyInterval |
Es la frecuencia con la que se envían notificaciones de recordatorio para los incidentes abiertos. El valor debe ser de entre 30 minutos y 24 horas. Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
Alineador
El Aligner especifica la operación que se aplicará a los datos de cada período de alineación en una serie temporal. Excepto por ALIGN_NONE, que especifica que no se aplique ninguna operación, cada operación de alineación reemplaza el conjunto de valores de datos en cada período de alineación por un solo valor: el resultado de aplicar la operación a los valores de datos. Una serie temporal alineada tiene un solo valor de datos al final de cada alignment_period.
Una operación de alineación también puede cambiar el tipo de datos de los valores. Por ejemplo, si aplicas una operación de recuento a valores booleanos, los datos value_type en la serie temporal original son BOOLEAN, pero el value_type en el resultado alineado es INT64.
| Enums | |
|---|---|
ALIGN_NONE |
No hay alineación. Se devuelven los datos sin procesar. No es válido si se solicita una reducción en varias series. El value_type del resultado es el mismo que el value_type de la entrada. |
ALIGN_DELTA |
Alinear y convertir a Esta alineación es válida para las métricas |
ALIGN_RATE |
Alinear y convertir a una tasa El resultado se calcula como Este alineador es válido para las métricas Si, con "tasa", te refieres a "cambio porcentual", consulta el alineador de |
ALIGN_INTERPOLATE |
Alinea los datos interpolando entre los puntos adyacentes alrededor del límite del período de alineación. Este alineador es válido para las métricas de GAUGE con valores numéricos. El value_type del resultado alineado es el mismo que el value_type de la entrada. |
ALIGN_NEXT_OLDER |
Para la alineación, se mueve el dato más reciente antes del final del período de alineación al límite que se encuentra al final del período de alineación. Este alineador es válido para las métricas de GAUGE. El value_type del resultado alineado es el mismo que el value_type de la entrada. |
ALIGN_MIN |
Alinea la serie temporal devolviendo el valor mínimo en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos. El value_type del resultado alineado es el mismo que el value_type de la entrada. |
ALIGN_MAX |
Alinea la serie temporal devolviendo el valor máximo en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos. El value_type del resultado alineado es el mismo que el value_type de la entrada. |
ALIGN_MEAN |
Alinea la serie temporal devolviendo el valor medio en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos. El value_type del resultado alineado es DOUBLE. |
ALIGN_COUNT |
Alinea la serie temporal mostrando la cantidad de valores en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos o booleanos. El value_type del resultado alineado es INT64. |
ALIGN_SUM |
Alinea la serie temporal devolviendo la suma de los valores en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos y de distribución. El value_type del resultado alineado es el mismo que el value_type de la entrada. |
ALIGN_STDDEV |
Alinea la serie temporal devolviendo la desviación estándar de los valores en cada período de alineación. Este alineador es válido para las métricas GAUGE y DELTA con valores numéricos. El value_type del resultado es DOUBLE. |
ALIGN_COUNT_TRUE |
Alinea la serie temporal devolviendo la cantidad de valores True en cada período de alineación. Este alineador es válido para las métricas de GAUGE con valores booleanos. El value_type del resultado es INT64. |
ALIGN_COUNT_FALSE |
Alinea la serie temporal devolviendo la cantidad de valores False en cada período de alineación. Este alineador es válido para las métricas de GAUGE con valores booleanos. El value_type del resultado es INT64. |
ALIGN_FRACTION_TRUE |
Alinea la serie temporal devolviendo la proporción de la cantidad de valores de True con respecto a la cantidad total de valores en cada período de alineación. Este alineador es válido para las métricas de GAUGE con valores booleanos. El valor de salida está en el rango [0.0, 1.0] y tiene value_type DOUBLE. |
ALIGN_PERCENTILE_99 |
Alinea la serie temporal con la agregación de percentiles. El dato resultante en cada período de alineación es el percentil 99 de todos los datos del período. Este alineador es válido para las métricas GAUGE y DELTA con valores de distribución. El resultado es una métrica de GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_95 |
Alinea la serie temporal con la agregación de percentiles. El dato resultante en cada período de alineación es el percentil 95 de todos los datos del período. Este alineador es válido para las métricas GAUGE y DELTA con valores de distribución. El resultado es una métrica de GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_50 |
Alinea la serie temporal con la agregación de percentiles. El dato resultante en cada período de alineación es el percentil 50 de todos los datos del período. Este alineador es válido para las métricas GAUGE y DELTA con valores de distribución. El resultado es una métrica de GAUGE con value_type DOUBLE. |
ALIGN_PERCENTILE_05 |
Alinea la serie temporal con la agregación de percentiles. El dato resultante en cada período de alineación es el percentil 5 de todos los datos del período. Este alineador es válido para las métricas GAUGE y DELTA con valores de distribución. El resultado es una métrica de GAUGE con value_type DOUBLE. |
ALIGN_PERCENT_CHANGE |
Alinear y convertir a un cambio porcentual Este alineador es válido para las métricas Si los valores de En cada punto del período de alineación anterior al cálculo mencionado, se calcula una media móvil de 10 minutos para suavizar la métrica y evitar falsos positivos a partir de picos de muy corta duración. La media móvil solo se aplica a los datos cuyos valores son |
Reductor
Una operación de reductor describe cómo agregar datos de varias series temporales en una sola, en la que el valor de cada dato de la serie resultante es una función de todos los valores ya alineados en las series temporales de entrada.
| Enums | |
|---|---|
REDUCE_NONE |
No hay reducción entre series temporales. Se muestra el resultado de Aligner. |
REDUCE_MEAN |
Reduce el valor calculando la media en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE con valores numéricos o de distribución. El value_type del resultado es DOUBLE. |
REDUCE_MIN |
Reduce el valor calculando el valor mínimo en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE con valores numéricos. El value_type del resultado es el mismo que el value_type de la entrada. |
REDUCE_MAX |
Reduce el valor calculando el valor máximo en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE con valores numéricos. El value_type del resultado es el mismo que el value_type de la entrada. |
REDUCE_SUM |
Reduce mediante el cálculo de la suma en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE con valores numéricos y de distribución. El value_type del resultado es el mismo que el value_type de la entrada. |
REDUCE_STDDEV |
Reduce el valor calculando la desviación estándar en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE con valores numéricos o de distribución. El value_type del resultado es DOUBLE. |
REDUCE_COUNT |
Reduce el valor calculando la cantidad de datos en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE de value_type numéricos, booleanos, de distribución y de cadena. El value_type del resultado es INT64. |
REDUCE_COUNT_TRUE |
Reduce el valor calculando la cantidad de datos con valor True en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE del tipo booleano value_type. El value_type del resultado es INT64. |
REDUCE_COUNT_FALSE |
Reduce el valor calculando la cantidad de datos con valor False en las series temporales para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE del tipo booleano value_type. El value_type del resultado es INT64. |
REDUCE_FRACTION_TRUE |
Reduce el cálculo de la proporción entre la cantidad de datos con valores True y la cantidad total de datos para cada período de alineación. Este reductor es válido para las métricas DELTA y GAUGE del valor booleano value_type. El valor de salida está en el rango [0.0, 1.0] y tiene value_type DOUBLE. |
REDUCE_PERCENTILE_99 |
Reduce el valor calculando el percentil 99 de los datos en las series temporales para cada período de alineación. Este reductor es válido para las métricas GAUGE y DELTA de tipo numérico y de distribución. El valor de la salida es DOUBLE. |
REDUCE_PERCENTILE_95 |
Reduce el valor calculando el percentil 95 de los datos en las series temporales para cada período de alineación. Este reductor es válido para las métricas GAUGE y DELTA de tipo numérico y de distribución. El valor de la salida es DOUBLE. |
REDUCE_PERCENTILE_50 |
Reduce el valor calculando el percentil 50 de los datos en las series temporales para cada período de alineación. Este reductor es válido para las métricas GAUGE y DELTA de tipo numérico y de distribución. El valor de la salida es DOUBLE. |
REDUCE_PERCENTILE_05 |
Reduce mediante el cálculo del percentil 5 de los datos en las series temporales para cada período de alineación. Este reductor es válido para las métricas GAUGE y DELTA de tipo numérico y de distribución. El valor de la salida es DOUBLE. |
ComparisonType
Especifica una relación de ordenamiento en dos argumentos, llamados left y right.
| Enums | |
|---|---|
COMPARISON_UNSPECIFIED |
No se especifica ninguna relación de orden. |
COMPARISON_GT |
Es verdadero si el argumento de la izquierda es mayor que el de la derecha. |
COMPARISON_GE |
Es verdadero si el argumento de la izquierda es mayor o igual que el argumento de la derecha. |
COMPARISON_LT |
Es verdadero si el argumento de la izquierda es menor que el de la derecha. |
COMPARISON_LE |
Es verdadero si el argumento de la izquierda es menor o igual que el argumento de la derecha. |
COMPARISON_EQ |
Es verdadero si el argumento de la izquierda es igual al argumento de la derecha. |
COMPARISON_NE |
Es verdadero si el argumento de la izquierda no es igual al argumento de la derecha. |
EvaluationMissingData
Es un control de condición que determina cómo se evalúan las condiciones de umbral de métrica cuando dejan de llegar datos. Este control no afecta las políticas de ausencia de métricas.
| Enums | |
|---|---|
EVALUATION_MISSING_DATA_UNSPECIFIED |
Es una opción de evaluación de datos faltantes sin especificar. Equivale a EVALUATION_MISSING_DATA_NO_OP. |
EVALUATION_MISSING_DATA_INACTIVE |
Si no hay datos para evaluar la condición, evalúala como falsa. |
EVALUATION_MISSING_DATA_ACTIVE |
Si no hay datos para evaluar la condición, evalúala como verdadera. |
EVALUATION_MISSING_DATA_NO_OP |
No evalúes la condición en ningún valor si no hay datos. |
ConditionCombinerType
Operadores para combinar condiciones.
| Enums | |
|---|---|
COMBINE_UNSPECIFIED |
Es un combinador no especificado. |
AND |
Combina condiciones con el operador lógico AND. Solo se crea un incidente si se cumplen todas las condiciones de forma simultánea. Este combinador se satisface si se cumplen todas las condiciones, incluso si se cumplen en recursos completamente diferentes. |
OR |
Combina condiciones con el operador lógico OR. Se crea un incidente si se cumple alguna de las condiciones enumeradas. |
AND_WITH_MATCHING_RESOURCE |
Combina condiciones con el operador lógico AND, pero, a diferencia de la opción AND normal, se crea un incidente solo si se cumplen todas las condiciones de forma simultánea en al menos un recurso. |
NotificationPrompt
Controla cuándo se enviarán las notificaciones.
| Enums | |
|---|---|
NOTIFICATION_PROMPT_UNSPECIFIED |
No se especificó ninguna estrategia. Se trata como error. |
OPENED |
Recibir notificaciones cuando se abre un incidente |
CLOSED |
Recibir notificaciones cuando se cierre un incidente |
Gravedad
Es una enumeración del nivel de gravedad posible para una política de alertas.
| Enums | |
|---|---|
SEVERITY_UNSPECIFIED |
No se especificó la gravedad. Este es el valor predeterminado. |
CRITICAL |
Este es el nivel de gravedad más alto. Usa esta opción si el problema podría causar daños o tiempo de inactividad significativos. |
ERROR |
Este es el nivel de gravedad medio. Usa esta opción si el problema podría causar daños menores o tiempo de inactividad. |
WARNING |
Este es el nivel de gravedad más bajo. Usa esta opción si el problema no causa daños ni tiempo de inactividad, pero podría generar un problema en el futuro. |
Anotaciones de herramientas
Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌