Datadog

Połącz Datadog, aby agenci mogli odpytywać twoje logi, metryki, monitory i dashboardy podczas dochodzeń.

Konfiguracja

1. Wybierz swoją witrynę Datadog (US1, US3, US5, EU1, AP1 itd.). Sprawdź swój adres URL Datadog: app.datadoghq.com to US1, app.datadoghq.eu to EU1.
2. Wpisz swój klucz API z Organization Settings → API Keys.
3. Wpisz swój klucz aplikacji z Organization Settings → Application Keys.
4. Polylane weryfikuje oba klucze i łączy się.

Klucz aplikacji bez zakresów ma ten sam dostęp co twój użytkownik i działa bez zmian. Jeśli ograniczasz klucz zakresami, dołącz user_app_keys (wymagany do połączenia) 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 i create_webhooks. Twoje klucze są szyfrowane przed zapisaniem, a agent nigdy ich nie widzi.

Połączenie tworzy w Datadog webhook o nazwie polylane i subskrybuje do niego każdy monitor, więc alerty trafiają do Polylane i przechodzą triaż na bieżąco.

Co mogą agenci

• Przeszukiwać i filtrować logi składnią zapytań Datadog
• Czytać wartości metryk i trendy w czasie
• Sprawdzać, które monitory alertują, i ich status
• Odwoływać się do danych dashboardów w dochodzeniach

Odłączanie

Odłącz Datadog w Polylane, a potem odwołaj klucz aplikacji i klucz API w Datadog.

Polylane subskrybuje monitor, dopisując do jego komunikatu wzmiankę @webhook-polylane i dodając tag polylane:managed. Cykliczna synchronizacja stosuje oba do każdego monitora, więc monitor zarządzany przez Terraform pokazuje drift, dopóki jego konfiguracja Terraform też ich nie zawiera. Dodaj oba do każdego monitora:

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"])
}

Najprostsza konfiguracja zostawia sam webhook pod zarządzaniem Polylane, a w Terraform umieszcza tylko wzmiankę i tag. Jeśli zarządzasz webhookami także w Terraform, zaimportuj istniejący zamiast go tworzyć, bo nazwy webhooków Datadog są unikalne. Najpierw dodaj blok zasobu, potem zaimportuj:

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

Token telemetrii uwierzytelnia dostarczanie alertów do twojego obszaru roboczego. Znajdziesz go w Polylane w Settings → Telemetry tokens (token o nazwie datadog-integration) albo utwórz nowy token na tej samej stronie. Ponowne połączenie integracji odtwarza webhook ze świeżym tokenem, więc zaimportowany webhook wymaga potem aktualizacji zmiennej z tokenem.