> ## Documentation Index
> Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Custo
> Retorna o gasto de LLM que os controllers registraram por incidente — custo total, quantidade de incidentes e custo por incidente para um namespace e janela
Namespace do Kubernetes cujo ledger ler. Vazio agrega o ledger de todos os namespaces.
Data inicial no formato RFC3339
Data final no formato RFC3339 (padrão: agora). A janela padrão é de 30 dias.
## Campos do Resumo
| Campo | Descrição |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `periodStart` / `periodEnd` | Limites da janela |
| `totalLLMCost` | Soma do `estimatedCostUSD` de cada incidente registrado dentro da janela (entradas sem `recordedAt`, escritas antes do carimbo existir, sempre contam) |
| `incidentCount` | Incidentes com entrada no ledger dentro da janela |
| `costPerIncident` | `totalLLMCost / incidentCount` |
O ledger vive em um ConfigMap `chatcli-cost-ledger` por namespace; veja [Capacidade, Ruído e Custo](/pt/features/aiops/capacity-cost#cost-tracker) para o formato e o override de preços.
```json Response 200 theme={"system"}
{
"apiVersion": "v1",
"kind": "CostSummary",
"spec": {
"periodStart": "2026-08-26T14:00:00Z",
"periodEnd": "2026-09-25T14:00:00Z",
"totalLLMCost": 18.72,
"incidentCount": 312,
"costPerIncident": 0.06
}
}
```
## OpenAPI
````yaml GET /analytics/cost
openapi: 3.1.0
info:
title: ChatCLI AIOps Platform API
description: >-
REST API for the ChatCLI AIOps Platform — incidents, SLOs, runbooks,
approvals, postmortems, analytics, audit, federation and health.
The playground below uses **editable server variables** so you can point
requests at your own self-hosted instance. Adjust `host`, `port` and
`basePath` to match your deployment, then click **Try it**.
version: 1.0.0
contact:
name: ChatCLI
url: https://github.com/diillson/chatcli
license:
name: Apache-2.0
identifier: Apache-2.0
servers:
- url: http://{host}:{port}/{basePath}
description: >-
Self-hosted ChatCLI AIOps Platform — adjust host, port and basePath to
match your deployment.
variables:
host:
default: localhost
description: >-
Hostname or IP of your ChatCLI operator. For Kubernetes, use the
Service DNS (e.g. chatcli-api.chatcli-system.svc) or your Ingress
host.
port:
default: '8090'
description: >-
Port the API listens on. Default is 8090; configurable via Helm value
`apiPort` or env var CHATCLI_API_PORT.
basePath:
default: api/v1
description: >-
API base path. Always `api/v1` unless you have a custom proxy rewrite
in front of the operator.
security:
- ApiKeyAuth: []
tags:
- name: Incidents
description: >-
Incident lifecycle: list, fetch, acknowledge, resolve, snooze, timeline
and remediation views.
- name: Runbooks
description: Remediation runbooks (list, create, update, delete).
- name: SLOs
description: Service Level Objectives and error budgets.
- name: Approvals
description: Approval workflow for risky remediations.
- name: Postmortems
description: Auto-generated postmortems with review, feedback and close.
- name: Remediations
description: Remediation plans and agentic execution history.
- name: AI Insights
description: AI root-cause analysis and recommendations per incident.
- name: Analytics
description: 'Operational analytics: MTTD, MTTR, trends, capacity, compliance.'
- name: Audit
description: Immutable audit log and exports.
- name: Federation
description: 'Multi-cluster federation: clusters, status and cross-cluster correlations.'
- name: Policies
description: >-
Read-only view of ApprovalPolicy, NotificationPolicy, EscalationPolicy and
IncidentSLA objects.
- name: Health
description: Liveness and readiness probes.
paths:
/analytics/cost:
get:
tags:
- Analytics
summary: Cost Summary
description: >-
Returns the LLM spend the controllers booked per incident: total cost,
incident count and cost per incident for the namespace and window.
Without a namespace it aggregates every namespace's ledger.
operationId: analyticsCost
parameters:
- name: namespace
in: query
required: false
description: Ledger to read. Empty aggregates every namespace.
schema:
type: string
- name: from
in: query
required: false
description: Start date (RFC3339).
schema:
type: string
format: date-time
- name: to
in: query
required: false
description: 'End date (RFC3339). Default: now. Default window: 30 days.'
schema:
type: string
format: date-time
responses:
'200':
description: Cost summary
content:
application/json:
schema:
$ref: '#/components/schemas/CostSummaryResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
components:
schemas:
CostSummaryResponse:
type: object
properties:
apiVersion:
type: string
example: v1
kind:
type: string
example: CostSummary
spec:
type: object
properties:
periodStart:
type: string
format: date-time
periodEnd:
type: string
format: date-time
totalLLMCost:
type: number
description: >-
Sum of every incident's estimatedCostUSD booked inside the
window.
incidentCount:
type: integer
costPerIncident:
type: number
description: totalLLMCost / incidentCount.
Error:
type: object
required:
- apiVersion
- kind
- error
properties:
apiVersion:
type: string
example: v1
kind:
type: string
example: Error
error:
oneOf:
- type: object
required:
- code
- message
properties:
code:
type: integer
example: 404
message:
type: string
example: Resource not found
details:
type: string
- type: string
code:
type: integer
description: Top-level code (only used by some endpoints).
example: 400
responses:
Unauthorized:
description: Missing or invalid API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
RateLimited:
description: Rate limit exceeded for this token's role
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
Bearer token issued by the operator. Format: `Authorization: Bearer
`.
````