Hub Log Middleware

API Middleware para consulta, análise e download de logs do Airflow na plataforma Fracttal.

Visão geral

Hub Log Middleware é uma camada de integração que expõe endpoints RESTful unificados para consulta, análise e download de logs do Airflow.

URL base

http://<host>:<port>/api/v1

Grupos de endpoints

Grupo	Prefixo	Descrição
DAGs	/api/v1	Navegação de DAGs e execuções por empresa
Runs	/api/v1/runs	Artefatos e busca avançada por execução
Artifacts	/api/v1/artifacts	Download e acesso a artefatos
Problems	/api/v1/problems	Catálogo de erros RFC 9457

Autenticação

Todos os endpoints requerem um Bearer Token no header Authorization. Ver Autenticação.

Conceitos-chave

Antes de consumir a API, recomendamos a leitura de:

• Paginação — como percorrer listas grandes e usar o stream.
• Filtros e datas — intervalos de datas, níveis, busca por texto e ordenação.
• Tratamento de erros — formato de erro RFC 9457 e como tratar cada código.

Health check

GET /health

Retorna o status da API.

{
  "status": "healthy",
  "app_name": "Hub Log Middleware",
  "version": "1.0.0",
  "environment": "production"
}

Documentação interativa

A API expõe uma interface de testes interativa. Solicite a URL de acesso à equipe responsável pelo serviço.