ayaFlow

ayaFlow é um analisador de tráfego de rede em Rust + eBPF construído com Aya. Ele executa um agente por nó Linux, anexa um classificador TC na entrada e saída, e expõe dados de tráfego ao vivo, histórico com suporte a SQLite e métricas do Prometheus.

O Que Faz

• Captura tráfego IPv4, IPv6, TCP e UDP com um classificador TC eBPF.
• Mantém estatísticas de conexão ao vivo em memória e registros históricos no SQLite.
• Opcionalmente enriquece o tráfego com DNS reverso, domínios de consulta DNS e SNI TLS.
• Expõe uma API REST, stream WebSocket e endpoint /metrics do Prometheus.
• Acompanha exemplos para Docker, Kubernetes, Prometheus e Grafana.

Fluxo de Desenvolvimento Suportado

O runtime de captura de pacotes do ayaFlow é apenas para Linux. Os fluxos de trabalho do contribuidor são divididos propositalmente:

• Verificações seguras para host em macOS ou Linux:
  • cargo test -p ayaflow-common
  • cargo test -p ayaflow
  • cargo xtask build-user
  • cargo xtask check-host
• Construção e runtime apenas para Linux:
  • cargo xtask build-ebpf
  • cargo xtask build
  • cargo xtask run -- --deep-inspect

Se você estiver no macOS, use Docker ou uma VM Linux para o fluxo de trabalho completo do eBPF. Veja HOW_TO_USE_LOCAL.md para ambos os caminhos.

Início Rápido

1. Verifique o suporte do host

cargo xtask check-host

2. Construa no Linux

cargo xtask build

3. Execute no Linux

sudo ./target/debug/ayaflow --db-path /tmp/traffic.db

Se --interface for omitido, o ayaFlow detecta automaticamente a interface de rota padrão a partir de /proc/net/route e usa eth0 como fallback apenas se a detecção falhar.

4. Verifique

curl http://localhost:3000/api/health
curl http://localhost:3000/api/stats
curl "http://localhost:3000/api/history?limit=5&row_type=raw"
curl http://localhost:3000/metrics

Opções da CLI

Referência da API

/api/history suporta:

• limit, offset
• start_time, end_time
• protocol
• ip, src_ip, dst_ip
• port, src_port, dst_port
• direction
• domain
• row_type=raw|aggregated

Exemplo:

curl "http://localhost:3000/api/history?limit=20&protocol=TCP&dst_port=443&row_type=raw"

Estrutura do Projeto

ayaflow/           Runtime de userspace, API, armazenamento e testes seguros para host
ayaflow-common/    Tipos de pacotes/eventos compartilhados usados pelo userspace e eBPF
ayaflow-ebpf/      Classificador TC e programa de captura de payload
xtask/             Ferramentas de construção e auxiliares de fluxo de trabalho
k8s/               Manifestos Kubernetes
monitoring/        Ativos do Prometheus e Grafana

A árvore src/ duplicada no nível raiz é legado e não faz parte do caminho de construção suportado. Use a crate ayaflow/ e os comandos cargo xtask acima.

Guias de Implantação

• Fluxo de trabalho local Linux e macOS+VM: HOW_TO_USE_LOCAL.md
• Docker: HOW_TO_USE_DOCKER.md
• Kubernetes: HOW_TO_USE_K8S.md

Documentos Técnicos

• Arquitetura: ARCHITECTURE.md
• Notas de pegada e desempenho: PERFORMANCE.md

Testado Aqui

O fluxo de trabalho seguro para host agora passa nesta máquina de desenvolvimento macOS com:

• cargo test -p ayaflow-common
• cargo test -p ayaflow
• cargo xtask check-host

A validação do runtime apenas para Linux ainda precisa ser feita em um host Linux ou runner de CI com a toolchain eBPF instalada.

Licença

Este projeto utiliza três licenças diferentes dependendo do componente:

Componentes de Userspace

O agente de userspace e as bibliotecas comuns (ayaflow e ayaflow-common) são duplamente licenciados sob:

• Apache License, Version 2.0
• MIT License

à sua escolha.

Componentes de Kernel

Os componentes de kernel eBPF (ayaflow-ebpf) são licenciados estritamente sob a GNU General Public License v2.0 (GPL) para garantir compatibilidade com o verificador do kernel Linux.