O que elasticsearch-esql faz?
Execute consultas ES|QL (Elasticsearch Query Language), use quando o usuário quiser consultar dados do Elasticsearch, analisar logs, agregar métricas, explorar dados ou criar gráficos e painéis a partir de resultados ES|QL.
Como usar
Para utilizar esta skill, forneça uma consulta ES|QL válida. Exemplo:
FROM logs-* | WHERE @timestamp > NOW() - 1d | STATS avg_cpu = AVG(cpu_usage) BY host.name | SORT avg_cpu DESC
Parâmetros
query(obrigatório): A consulta ES|QL a ser executada.format(opcional): Formato de saída esperado (por exemplo,json,csv,table). O padrão éjson.
Exemplo de resposta
[
{
"host.name": "web-server-01",
"avg_cpu": 67.5
},
{
"host.name": "web-server-02",
"avg_cpu": 72.1
}
]
Configuração
Certifique-se de que as seguintes variáveis de ambiente estejam definidas:
ELASTICSEARCH_HOST: URL do cluster Elasticsearch (ex.:https://my-cluster.es.us-east-1.aws.cloud.es.io:9243)ELASTICSEARCH_API_KEY: Chave de API para autenticação
Ou, alternativamente, configure ELASTICSEARCH_USERNAME e ELASTICSEARCH_PASSWORD.
Restrições
- A skill só pode executar consultas ES|QL, não comandos de administração do cluster.
- O limite de tempo para cada consulta é de 30 segundos.
- Resultados com mais de 10.000 linhas serão truncados (considere usar agregações para reduzir o volume).