Serverless App Engine:Gestión de contactos

Crear un contacto

Primero vaya a la página de gestión de contactos: inicie sesión en la consola de SAE , vaya a Applications > Applications , seleccione su región y espacio de nombres, haga clic en el nombre de una aplicación y luego elija Notifications and Alerts > Contact Management en el panel de navegación izquierdo.

1. En la página Notification Objects, vaya a la pestaña Contacts y haga clic en Create Contact.

2. En el cuadro de diálogo Create Contact, complete los datos del contacto y haga clic en OK.

   Especifique como mínimo uno de los siguientes campos: Phone number o Email . Cada número de teléfono y dirección de correo electrónico solo puede pertenecer a un contacto. Para configurar un chatbot de DingTalk, utilice la pestaña DingTalk/Lark/WeCom .

   Parámetro	Descripción
   Name	El nombre del contacto.
   Phone number	Habilita las notificaciones por llamada telefónica y mensaje de texto. Solo se pueden usar números de teléfono verificados en una política de notificación. Consulte Verify phone numbers.
   Email	Habilita las notificaciones por correo electrónico.
   Contact group	El grupo de contactos al que se agregará este contacto. Consulte Create a contact group.
   Method to resend notifications if phone notifications fail	El método alternativo cuando falla una llamada telefónica. Establezca un valor predeterminado global para todos los contactos en More > Contact Default Configuration dentro de la pestaña Contacts.
   User ID	Un identificador utilizado para el procesamiento y consulta de datos.

Después de crear un contacto, puede buscarlo, editarlo o eliminarlo en la pestaña Contacts.

Verificar números de teléfono

Los números de teléfono deben verificarse antes de poder usarse en una política de notificación. El código de verificación se envía al número de teléfono que se está verificando; los contactos deben tener acceso a ese número para completar la verificación.

1. En la pestaña Contacts de la página Notification Objects, seleccione los contactos cuyos números desea verificar: SAE enviará un mensaje de texto con un enlace de verificación a cada número seleccionado.

   • Para verificar un solo número, busque el contacto y haga clic en Not Verified junto al número de teléfono.

   • Para verificar varios números a la vez, seleccione los contactos y haga clic en Batch Verify.

2. Cada contacto abre la URL del mensaje de texto en un navegador.

3. En la página de verificación, el contacto comprueba el número y hace clic en Verify.

Configurar el método alternativo predeterminado

Cuando falla una notificación telefónica, SAE utiliza un método alternativo para reenviar la alerta. Configure un valor predeterminado global para todos los contactos:

1. En la pestaña Contacts de la página Notification Objects, elija More > Contact Default Configuration.

2. Seleccione el método alternativo y haga clic en OK.

Los contactos individuales pueden anular este valor predeterminado mediante el parámetro Method to resend notifications if phone notifications fail al crear o editar un contacto.

Requisitos previos

Debe existir como mínimo un contacto. Consulte Create a contact.

Crear un grupo de contactos

1. En la pestaña Contacts de la página Notification Objects, haga clic en Create Contact Group.

2. En el cuadro de diálogo Create Contact Group, introduzca un nombre en Group Name, seleccione contactos de la lista Alert Contacts y haga clic en OK.

El grupo de contactos aparecerá en la lista All Contacts dentro de la pestaña Contacts.

Gestionar un grupo de contactos

Después de crear un grupo de contactos, gestiónele desde la pestaña Contacts:

Requisitos previos

Un grupo de DingTalk con un chatbot personalizado agregado y la URL del webhook del chatbot. Consulte Get the webhook URL of a DingTalk chatbot.

Agregar un chatbot de DingTalk

1. En la página Notification Objects, haga clic en la pestaña DingTalk/Lark/WeCom y luego en DingTalk.

2. En el panel Create DingTalk chatbot, configure los parámetros y haga clic en OK.

   Para recibir alertas en un grupo de DingTalk, establezca Notification methods en DingTalk dentro de la política de notificación. Consulte Configure a notification policy .

   Parámetro	Descripción
   Name	Un nombre para el chatbot de DingTalk.
   Signature key	Opcional. Si se especifica, DingTalk autentica las solicitudes mediante la clave de firma. Si se deja en blanco, la autenticación utiliza una lista blanca con la palabra clave Alert.
   Chatbot webhook URL	La URL del webhook del chatbot de DingTalk.
   Whether DingTalk chatbot sends daily statistics	Si se habilita, introduzca las horas para enviar resúmenes diarios. Formato: HH:SS, separados por comas. Cada resumen incluye el total de alertas generadas ese día, las alertas resueltas y las alertas pendientes.
   Card content configuration	Personalice el estilo y el contenido de la tarjeta de notificación de alerta.

Gestionar alertas en un grupo de DingTalk

Después de recibir notificaciones de alerta en el grupo de DingTalk, puede verlas y gestionarlas directamente en el grupo. Para más detalles, consulte Handle alerts in the specified group chat.

Paso 1: Obtener una URL de webhook

1. Abra Lark e inicie sesión.

2. Haga clic en + > New group para crear un grupo destinado a recibir alertas.

3. Abra Group settings, vaya a la pestaña BOTs y haga clic en Add Bot.

4. Seleccione Custom Bot, establezca un nombre y una descripción, y haga clic en Add.

5. Copie la URL del webhook. En Set keywords, introduzca Alert y haga clic en Save.

Paso 2: Crear un webhook en SAE

1. En la página Notification Objects, vaya a la pestaña Webhook Integration y haga clic en Create Webhook.

2. En el panel Create Webhook, configure los parámetros. Ejemplo de plantilla de notificación (Lark):

   Parámetro	Descripción
   Webhook name	Un nombre para el webhook.
   Post/Get	El método de solicitud. La URL no puede exceder los 100 caracteres. Para Lark, seleccione Post y pegue la URL del webhook obtenida en el Paso 1.
   Header/Param	Encabezados o parámetros adicionales de la solicitud. Máximo de 6 entradas en total; máximo de 200 caracteres combinados. El encabezado predeterminado es Content-Type: text/plain; charset=UTF-8. Para Lark, agregue Arms-Content-Type: json y Content-Type: application/json.
   Notification template	El cuerpo del mensaje que se envía cuando se dispara una alerta (solo POST). Utilice $content como marcador de posición para el contenido de la alerta. Máximo de 500 caracteres. Consulte Configure a notification template and a webhook template.
   Template to clear alerts	El cuerpo del mensaje que se envía cuando se resuelve una alerta (solo POST). Máximo de 500 caracteres.

   {
     "msg_type": "text",
     "content": {
       "text": "Alert name: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}Cluster name: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}Application name: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}Notification policy: {{ .dispatchRuleName }} \nAlert time: {{ .startTime }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

   Ejemplo de plantilla para resolver alertas (Lark):

   {
     "msg_type": "text",
     "content": {
       "text": "Alert name: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}Cluster name: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}Application name: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}Time when the alert is resolved: {{ .endTime }} \nNotification policy: {{ .dispatchRuleName }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

3. Haga clic en Send Test para comprobar que el webhook funciona correctamente y luego haga clic en OK.

   El webhook tiene un tiempo de espera de 5 segundos. Si no se recibe respuesta en ese lapso, la notificación fallará.

Paso 3: Asociar el webhook a una política de notificación

Al crear o editar una política de notificación, establezca Notification object en Universal Webhook y seleccione su webhook. Para más detalles, consulte Configurar una política de notificación.