Alle integrationer

AWS Cost Explorer

Forespørg AWS-forbrug, prognoser, cost allocation tags og Savings Plans- eller Reserved Instance-udnyttelse via Cost Explorer API.

Manual setup 10 værktøjer

Overblik

Forbind AWS Cost Explorer, så AI-klienter kan forespørge på historisk AWS-forbrug, omkostningsprognoser, dimensionsværdier (services, regioner, linked accounts), cost allocation tags og Savings Plans / Reserved Instance-udnyttelse.

Integrationen bruger AWS Cost Explorer API med IAM access keys gemt krypteret i stackgate.ai. API-brug faktureres på din AWS-konto ($0,01 pr. request).

For infrastrukturlogs og metrics, brug AWS CloudWatch. For S3-artifact-omkostninger i CI-sammenhæng, se AWS CodeBuild.

Forudsætninger

  • En AWS-konto med Cost Explorer aktiveret (AWS Billing-konsol → Cost Explorer → Enable; kan tage op til 24 timer)
  • For organisationsdata på tværs af linked accounts: IAM-legitimationsoplysninger fra management/payer-kontoen
  • En stackgate.ai-konto

Hent legitimationsoplysninger

  1. Opret en IAM-bruger (eller genbrug en automationsbruger) med programmatisk adgang i AWS IAM-konsollen.
  2. Vedhæft en least-privilege-policy. Eksempel til read-only Cost Explorer:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ce:GetCostAndUsage",
                "ce:GetCostForecast",
                "ce:GetDimensionValues",
                "ce:GetTags",
                "ce:GetUsageForecast",
                "ce:GetSavingsPlansUtilization",
                "ce:GetSavingsPlansCoverage",
                "ce:GetReservationUtilization",
                "ce:GetReservationCoverage",
                "ce:GetCostCategories"
            ],
            "Resource": "*"
        }
    ]
}
  1. Opret en access key og kopiér key ID og secret.
  2. Åbn Mine integrationer → AWS Cost Explorer i stackgate.ai.
  3. Klik Aktivér og indtast access key ID, secret access key og AWS-region (gemmes for konsistens; Cost Explorer API bruger altid us-east-1-endpointet).

Du kan genbruge samme IAM-bruger som Amazon S3, AWS CloudWatch eller andre AWS-integrationer med en sammenslået policy.

Brug med AI-klienter

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

Typisk workflow:

  1. get_dimension_values — find services, regioner eller linked accounts (dimension: SERVICE, REGION, LINKED_ACCOUNT)
  2. get_tags — list cost allocation tag-nøgler eller -værdier
  3. get_cost_and_usage — forespørg historisk forbrug (group_by, filtrér med services, region eller tags)
  4. get_cost_forecast — prognosticér kommende forbrug
  5. get_savings_plans_utilization / get_reservation_utilization — commitment-udnyttelse

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

Fejlfinding

  • 422 integration ikke konfigureret — udfyld alle påkrævede credential-felter under Mine integrationer.
  • 403 / AccessDenied fra AWS — verificér at IAM-policy inkluderer ce:Get*-actions og at Cost Explorer er aktiveret på kontoen.
  • DataUnavailableException / tomme resultater — Cost Explorer er måske ikke aktiveret endnu, eller datointervallet har ingen faktureringsdata.
  • LimitExceededException — for mange API-kald på kort tid. Hvert request koster $0,01; undgå hurtige gentagne forespørgsler.
  • Linked account-data mangler — brug management/payer-konto-legitimationsoplysninger for organisationsomfattende LINKED_ACCOUNT-dimensions.
  • HOURLY granularity-gebyrer — timeopdelte data har ekstra AWS-gebyrer ud over API-omkostningen pr. request. Foretræk DAILY eller MONTHLY, medmindre det er nødvendigt.

Tilgængelige værktøjer

  • get_dimension_values

    List tilgængelige dimensionsværdier (services, regioner, linked accounts) for en periode.

  • get_cost_and_usage

    Forespørg historisk AWS-forbrug og usage for en periode.

  • get_cost_forecast

    Prognosticér kommende AWS-forbrug baseret på historiske omkostninger.

  • get_tags

    List cost allocation tag keys or values active during a time period.

  • get_usage_forecast

    Forecast AWS usage quantity for a future time period.

  • get_savings_plans_utilization

    Retrieve Savings Plans utilization for a time period.

  • get_savings_plans_coverage

    Retrieve Savings Plans coverage for a time period.

  • get_reservation_utilization

    Retrieve Reserved Instance utilization for a time period.

  • get_reservation_coverage

    Retrieve Reserved Instance coverage for a time period.

  • get_cost_categories

    List cost category names available for a time period.

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