Esta guía te ayudará a configurar una integración de webhook para enviar alertas desde Dotcom-Monitor a tus tickets de Jira. Dotcom-Monitor aprovecha el método de entrega de alertas HTTP Webhook para conectar el sistema de alertas de Dotcom-Monitor y los tickets de Jira a través de solicitudes de webhook. Para configurar la integración, asegúrate de tener los permisos necesarios para crear incidencias en tu proyecto de Jira.

Configuración de integración

Generar token de API de Jira:

  1. Visita la página Autenticación básica para API de REST del portal para desarrolladores de Atlassian para obtener información sobre cómo generar un token de API y configurar la autenticación básica con Jira.
  2. Guarde el token de API generado para usarlo en el encabezado de autorización de Dotcom-Monitor.

Configurar el webhook en dotcom-monitor

Cuando se utilizan solicitudes de API, especialmente con encabezados de autenticación, JIRA a veces requiere un encabezado adicional para eludir la protección CSRF. Para solucionar este problema, incluye el encabezado X-Atlassian-Token con el valor no-check en tu solicitud de webhook.

  1. Inicie sesión en su cuenta de Dotcom-Monitor y vaya a la configuración de grupos de direcciones de entrega (Administrar > grupo de direcciones de entrega).
  2. Cree un nuevo grupo o abra uno existente para editarlo. Agregue webhook como dirección de entrega. Visite el artículo Integración de webhook HTTP para obtener información sobre cómo enviar mensajes de alerta de Dotcom-Monitor a una dirección URL de webhook dedicada.
  3. En el campo URL de webhook, escriba: https://your-domain.atlassian.net/rest/api/3/issue
  4. Establezca el Tipo de solicitud en POST.
  5. Deje vacía la sección Autenticación .
  6. En la sección Encabezados , agregue los siguientes encabezados. Asegúrese de codificar BASE64 la cadena useremail:api_token .:
    • Autorización: Basic [useremail:api_token]
    • Tipo de contenido: application/json
    • X-Atlassian-token: no-check
  7. En el campo Carga útil , introduzca la estructura de datos JSON que se enviará a Jira. A continuación, se muestra un ejemplo de carga útil: 
    @{
string _text = "";
foreach (var sessionResponse in Model.SessionResponses)
{
    foreach (var response in sessionResponse.Children)
    {
        _text += "Task Type: " + response.Task.TaskType_Name + ", " +
                 "Details Url: " + Model.DMUserLink + "/client/response-details/hit?id=" + response.ID + "&rootId=" + Model.RootResponse.ID + "&cuid=" + Model.OnlineReportCUID + ", " +
                 "View Task Url: " + Model.DMUserLink + "/v2/EditLegacyTask/" + response.Device.ID + "/" + response.Task.ID + ", " +
                 "Task Name: " + response.Name + ", " +
                 "Target: " + response.Target + ", ";

        if (response.AllErrors != null)
        {
            foreach (var error in response.AllErrors)
            {
                _text += error.ErrorType + " (" + error.ErrorCode + ") " + error.Reason;
            }
        }
    }
}
}
{
  "fields": {
    "project": {
      "key": "JIRA_PROJECT_KEY"
    },
    "summary": "Alert from Dotcom-Monitor",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "text":"@_text",
              "type": "text"
            }
          ]
        }
      ]
    },
    "issuetype": {
      "name": "Task"
    },
    "components": [
      {
        "name": "Default Component"
      }
    ]
  }
}
  8. Reemplázalo "PROJECT_KEY" con la clave de tu proyecto de Jira.

Probar el webhook

Una vez que se haya configurado la integración del webhook, le recomendamos que pruebe su dispositivo de monitoreo enviando una alerta de prueba:

  1. En la lista de dispositivos, coloque el cursor sobre el dispositivo de supervisión que desea probar.
  2. Haga clic en el menú Opciones (⋮) > Enviar alerta > de prueba hacia abajo.
  3. Comprueba tu proyecto de Jira para ver si la alerta ha creado un nuevo ticket.

Uso de variables dinámicas en la plantilla de alerta

Si necesita incluir variables dinámicas de Dotcom-Monitor en la carga JSON, consulte el artículo Adición de variables dinámicas a la plantilla de alerta . Si tiene algún problema o tiene requisitos específicos, póngase en contacto con el soporte técnico de Dotcom-Monitor para obtener más ayuda.