stackgate.ai
Alle integrationer

AWS CloudWatch

Udforsk CloudWatch log groups, filtrér loghændelser, kør Logs Insights-forespørgsler, og læs metrics og alarms via MCP.

Manual setup 9 værktøjer

Overblik

Forbind AWS CloudWatch, så AI-klienter kan udforske log groups og streams, filtrere eller tail'e loghændelser, køre Logs Insights-forespørgsler og læse metrics og alarms.

Integrationen bruger Amazon CloudWatch Logs og CloudWatch Metrics med IAM access keys gemt krypteret i stackgate.ai. Forbruget faktureres på din AWS-konto.

Har du allerede et build_id, brug AWS CodeBuild (get_build_logs) til build-specifikke logs.

Forudsætninger

  • En AWS-konto med CloudWatch Logs og/eller Metrics, som AI-klienter skal have adgang til
  • En stackgate.ai-konto

Hent credentials

  1. Opret en IAM-bruger (eller brug en eksisterende) med programmatisk adgang i AWS IAM-konsollen.
  2. Vedhæft en least-privilege-politik med read-only Logs og Metrics (se den engelske guide for et JSON-eksempel).
  3. Opret en access key og kopiér key ID og secret.
  4. Gå til Mine integrationer → AWS CloudWatch på stackgate.ai.
  5. Klik Aktivér og indtast access key ID, secret access key, AWS-region og eventuelt en standard log group (fx /aws/codebuild/CypressEnvironmentV2).

Du kan genbruge samme IAM-bruger som Amazon S3 eller AWS CodeBuild med en sammenslået politik.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/cloudwatch med Sanctum bearer token
  • Private gateway: én konfiguration for alle integrationer — brug cloudwatch__*-navngivne værktøjer

Typisk workflow:

  1. list_log_groups — find log groups (prefix: /aws/lambda/ eller /aws/codebuild/)
  2. list_log_streams — find seneste stream (order_by: LastEventTime, descending: true)
  3. filter_log_events — søg med filter_pattern (ERROR, Cypress osv.)
  4. get_log_events — tail en stream uden filter
  5. start_logs_insights_query + get_logs_insights_results — kør Logs Insights QL og poll til status er Complete
  6. list_metrics → get_metric_data — hent Lambda-, ECS- eller custom metrics
  7. describe_alarms — tjek alarm-tilstande

Se Dokumentation for HTTP-autentificering og private gateway-opsætning.

Fejlfinding

  • 422 integration not configured — udfyld alle påkrævede credential-felter under Mine integrationer.
  • 403 / AccessDenied fra AWS — verificér at IAM-politikken dækker Logs- og Metrics-read på de relevante ressourcer.
  • log_group is required — angiv log_group eller sæt en standard log group i Mine integrationer.
  • ThrottlingException / RateExceeded — CloudWatch Logs read-API'er har hårde TPS-grænser pr. region (fx 5 TPS for FilterLogEvents i eu-central-1). Paginér med next_token og undgå hurtige poll-loops.
  • Insights-forespørgsel stadig Running — poll get_logs_insights_results til status er Complete eller Failed.
  • Tomme metrics — bekræft namespace, metric_name, dimensions og tidsinterval matcher metric'ens publiceringsinterval.

Tilgængelige værktøjer

  • list_log_groups

    List CloudWatch log groups in the connected AWS account.

  • list_log_streams

    List log streams in a CloudWatch log group.

  • filter_log_events

    Søg i loghændelser i en log group med et valgfrit filter_pattern.

  • get_log_events

    Tail log events from a specific log stream without a filter pattern.

  • start_logs_insights_query

    Start en CloudWatch Logs Insights-forespørgsel på tværs af en eller flere log groups.

  • get_logs_insights_results

    Poll results for a CloudWatch Logs Insights query started with start_logs_insights_query.

  • list_metrics

    List CloudWatch metrics, optionally filtered by namespace, name, or dimensions.

  • get_metric_data

    Hent CloudWatch metric-datapunkter for en eller flere metric-forespørgsler.

  • describe_alarms

    List CloudWatch metric alarms and their current state.

MCP-endpoint: https://stackgate.ai/mcp/cloudwatch (HTTP) eller via private gateway.

Relaterede workflows

Multi-integrations-playbooks, der bruger AWS CloudWatch til konkrete forretningsresultater.

Opret konto Dokumentation