axiomhq/building-dashboards

O que building-dashboards faz?

Projeta e constrói dashboards do Axiom via API. Abrange tipos de gráfico, padrões de consulta APL e métricas/MPL, SmartFilters, layout e opções de configuração. Use ao criar dashboards, migrar do Splunk ou configurar opções de gráfico.

Tipos de Gráfico

• Série Temporal: Visualiza dados ao longo do tempo.
• Barra: Compara valores entre categorias.
• Tabela: Exibe dados em formato tabular.
• Mapa de Calor: Mostra intensidade de dados em uma matriz.

Padrões de Consulta

APL (Axiom Processing Language)

['your-dataset']
| where status >= 400
| summarize count() by bin(_time, 1h)

MPL (Metrics Processing Language)

| rate
| sum
| group_by ['service']

SmartFilters

Defina filtros inteligentes para interatividade do dashboard:

{
  "filters": [
    {
      "field": "service",
      "type": "select",
      "default": "api"
    }
  ]
}

Layout

Configure layout em grade com larguras e alturas personalizadas:

{
  "layout": {
    "columns": 12,
    "widgets": [
      {
        "x": 0,
        "y": 0,
        "w": 6,
        "h": 4
      }
    ]
  }
}

Opções de Configuração

• title: Título do dashboard.
• description: Descrição opcional.
• timeRange: Intervalo de tempo padrão.
• refreshInterval: Intervalo de atualização automática.

Migração do Splunk

Para migrar dashboards do Splunk, converta consultas SPL para APL/MPL e adapte o layout conforme as especificações do Axiom.

Exemplo de Uso via API

curl -X POST https://api.axiom.co/v1/dashboards \
  -H "Authorization: Bearer $AXIOM_TOKEN" \
  -d '{
    "name": "Meu Dashboard",
    "description": "Dashboard de exemplo",
    "widgets": [
      {
        "type": "timeseries",
        "query": {
          "apl": "['requests'] | where status >= 400 | summarize count() by bin(_time, 1h)"
        },
        "title": "Erros por Hora"
      }
    ]
  }'