Datadog

Forbind Datadog, så agenter kan forespørge på dine logs, metrikker, monitors og dashboards under undersøgelser.

Opsætning

1. Vælg dit Datadog-site (US1, US3, US5, EU1, AP1 og så videre). Kontrollér din Datadog-URL: app.datadoghq.com er US1, app.datadoghq.eu er EU1.
2. Indtast din API-nøgle fra Organization Settings → API Keys.
3. Indtast din applikationsnøgle fra Organization Settings → Application Keys.
4. Polylane validerer begge nøgler og forbinder.

En applikationsnøgle uden scopes har den samme adgang som din bruger og virker, som den er. Afgrænser du nøglen med scopes, så inkluder user_app_keys (påkrævet for at forbinde) plus logs_read_data, timeseries_query, metrics_read, monitors_read, monitors_write, monitors_downtime, dashboards_read, slos_read, hosts_read, events_read, incident_read, apm_read, aws_configuration_read og create_webhooks. Dine nøgler krypteres, før de gemmes, og agenten ser dem aldrig.

Forbindelsen opretter en webhook ved navn polylane i Datadog og abonnerer hver monitor på den, så alarmer lander i Polylane og triageres, efterhånden som de udløses.

Hvad agenter kan gøre

• Søge i og filtrere logs med Datadogs forespørgselssyntaks
• Læse metrikværdier og tendenser over tid
• Kontrollere hvilke monitors der alarmerer, og deres status
• Henvise til dashboard-data i undersøgelser

Afbrydelse

Afbryd Datadog i Polylane, og tilbagekald derefter applikations- og API-nøglerne i Datadog.

Polylane abonnerer en monitor ved at tilføje omtalen @webhook-polylane til dens besked og tilføje tagget polylane:managed. En tilbagevendende synkronisering anvender begge på hver monitor, så en Terraform-styret monitor viser drift, indtil dens Terraform-konfiguration også bærer dem. Tilføj begge til hver monitor:

resource "datadog_monitor" "high_error_rate" {
  name  = "High error rate on checkout"
  type  = "metric alert"
  query = "sum(last_5m):sum:trace.http.request.errors{service:checkout}.as_count() > 50"

  message = <<-EOT
    {{#is_alert}}Error rate on checkout is above threshold.{{/is_alert}}
    @webhook-polylane
  EOT

  tags = concat(var.tags, ["polylane:managed"])
}

Den enkleste opsætning lader selve webhooken forblive styret af Polylane og lægger kun omtalen og tagget i Terraform. Styrer du også webhooks i Terraform, så importér den eksisterende i stedet for at oprette den, da Datadog-webhook-navne er unikke. Tilføj ressourceblokken først, og importér derefter:

resource "datadog_webhook" "polylane" {
  name      = "polylane"
  url       = "https://sinks.polylane.com/v1/datadog"
  encode_as = "json"

  custom_headers = jsonencode({
    "x-polylane-telemetry-token" = var.polylane_telemetry_token
  })

  payload = jsonencode({
    alert_id         = "$ALERT_ID"
    alert_metric     = "$ALERT_METRIC"
    alert_query      = "$ALERT_QUERY"
    alert_scope      = "$ALERT_SCOPE"
    alert_status     = "$ALERT_STATUS"
    alert_title      = "$ALERT_TITLE"
    alert_transition = "$ALERT_TRANSITION"
    alert_type       = "$ALERT_TYPE"
    date             = "$DATE_POSIX"
    event_msg        = "$EVENT_MSG"
    event_title      = "$EVENT_TITLE"
    event_type       = "$EVENT_TYPE"
    hostname         = "$HOSTNAME"
    id               = "$ID"
    link             = "$LINK"
    logs_sample      = "$LOGS_SAMPLE"
    org_id           = "$ORG_ID"
    org_name         = "$ORG_NAME"
    priority         = "$PRIORITY"
    snapshot         = "$SNAPSHOT"
    tags             = "$TAGS"
    user             = "$USER"
    username         = "$USERNAME"
  })
}

terraform import datadog_webhook.polylane polylane

Telemetri-tokenet autentificerer alarmleveringer til dit arbejdsområde. Find det i Polylane under Settings → Telemetry tokens (tokenet ved navn datadog-integration), eller opret et nyt token på den samme side. Genforbindes integrationen, genoprettes webhooken med et nyt token, så en importeret webhook skal have sin tokenvariabel opdateret bagefter.