Datadog

Koble til Datadog slik at agenter kan spørre i loggene, metrikkene, monitorene og dashbordene dine under undersøkelser.

Oppsett

1. Velg Datadog-siten din (US1, US3, US5, EU1, AP1 og så videre). Sjekk Datadog-URL-en din: app.datadoghq.com er US1, app.datadoghq.eu er EU1.
2. Skriv inn API-nøkkelen din fra Organization Settings → API Keys.
3. Skriv inn applikasjonsnøkkelen din fra Organization Settings → Application Keys.
4. Polylane validerer begge nøklene og kobler til.

En applikasjonsnøkkel uten omfang har samme tilgang som brukeren din og fungerer som den er. Hvis du avgrenser nøkkelen, inkluder user_app_keys (kreves for å koble til) pluss 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. Nøklene dine krypteres før de lagres, og agenten ser dem aldri.

Tilkoblingen oppretter en webhook ved navn polylane i Datadog og abonnerer hver monitor på den, så varsler lander i Polylane og triageres etter hvert som de utløses.

Hva agenter kan gjøre

• Søke i og filtrere logger med Datadogs spørresyntaks
• Lese metrikkverdier og trender over tid
• Sjekke hvilke monitorer som varsler, og statusen deres
• Referere til dashborddata i undersøkelser

Frakobling

Koble Datadog fra i Polylane, og trekk så tilbake applikasjons- og API-nøklene i Datadog.

Polylane abonnerer en monitor ved å legge til @webhook-polylane-omtalen i meldingen dens og legge til taggen polylane:managed. En gjentakende synkronisering legger begge på hver monitor, så en Terraform-forvaltet monitor viser drift til Terraform-konfigurasjonen dens også bærer dem. Legg begge til på 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"])
}

Det enkleste oppsettet lar selve webhooken forvaltes av Polylane og legger bare omtalen og taggen i Terraform. Hvis du også forvalter webhooker i Terraform, importerer du den eksisterende i stedet for å opprette den, siden Datadog-webhooknavn er unike. Legg til ressursblokken først, og importer så:

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

Telemetritokenet autentiserer varselleveringer til workspacet ditt. Du finner det i Polylane under Settings → Telemetry tokens (tokenet ved navn datadog-integration), eller opprett et nytt token på samme side. Å koble integrasjonen til på nytt gjenoppretter webhooken med et nytt token, så en importert webhook trenger å få tokenvariabelen sin oppdatert etterpå.