Suporte a extensões de terceiros: integração com LogDNA

O MagicTradeBot oferece integração nativa com o LogDNA — uma plataforma de gerenciamento de logs nativa da nuvem que permite streaming de logs em tempo real e monitoramento centralizado. Essa integração permite que todos os eventos e logs gerados por cada instância do bot sejam enviados instantaneamente ao LogDNA.

Seja você responsável por uma única instância do bot ou esteja gerenciando centenas de instâncias em diferentes exchanges, contas, pares de símbolos ou servidores distribuídos, o LogDNA permite centralizar a observabilidade e o diagnóstico. O rastreamento manual em larga escala não é viável — o LogDNA resolve isso com dashboards intuitivos e indexação de alto desempenho.

🚀 Visão Geral

O MagicTradeBot pode enviar todos os logs e eventos de negociação para o LogDNA via API de ingestão ou agentes de logging. Com essa configuração, você pode:

  • Pesquisar, filtrar e visualizar logs por símbolo, exchange ou instância
  • Correlacionar erros, falhas de execução e problemas de API
  • Monitorar todas as atividades do bot em contas e exchanges em um só lugar

🔧 Recursos Principais

  • 📡 Streaming de logs em tempo real via HTTPS ou agente LogDNA
  • 🌍 Suporte para implantação em várias instâncias e servidores
  • 🧠 Logs pesquisáveis com tags e metadados personalizados
  • 📊 Dashboard centralizado para visualizar atividades de trading, erros e eventos
  • 🚨 Integrações de alertas com Slack, PagerDuty, Webhooks, etc.

🛠️ Pré-requisitos

  • Uma conta LogDNA válida
  • Sua LogDNA Ingest Key (chave de API)
  • Opcional: agente LogDNA instalado no ambiente de hospedagem do bot

⚙️ Etapas de Configuração

1. Obter a LogDNA Ingest Key

Faça login na sua conta LogDNA e vá para Configurações → Chaves de API para criar ou copiar sua chave de ingestão.

2. Atualizar a Configuração do Bot

Habilite o log do LogDNA no arquivo de configuração do seu bot (ex: config.yaml):

logging:
  logdna:
    enabled: true
    ingest_key: "YOUR_LOGDNA_API_KEY"
    app_name: "magictradebot"
    environment: "production"
    hostname: "bot-eu-1"
    tags:
      - exchange:binance
      - region:eu

3. (Opcional) Instalar o Agente LogDNA

Se preferir, instale o agente LogDNA no seu servidor (Linux/Windows/macOS):

curl -sSL https://assets.logdna.com/logdna-agent.sh | sudo bash -s -- -k YOUR_LOGDNA_API_KEY

Ou configure manualmente o arquivo /etc/logdna.conf e inicie o agente.

4. Implantar e Verificar

Execute seu bot e verifique se os logs estão sendo exibidos em tempo real no dashboard do LogDNA com as tags, nomes de host e IDs de instância corretos.

🧪 Exemplo de Log JSON do LogDNA

{
  "timestamp": "2025-06-20T12:12:11Z",
  "level": "info",
  "message": "Executed short trade",
  "exchange": "binance",
  "symbol": "DOGE/USDT",
  "strategy": "ScalpShort",
  "profit": 1.05,
  "bot_instance": "bot-apac-02"
}

✅ Benefícios da Integração com o LogDNA

  • 📍 Acesso unificado aos logs de todas as instâncias do bot em múltiplas exchanges
  • 🧩 Visibilidade completa sobre o desempenho da estratégia e comportamento em tempo de execução
  • 📈 Depuração e rastreamento de erros mais rápidos com filtros avançados
  • 🚨 Integração com ferramentas de alerta para resposta a incidentes em tempo real
  • 💾 Histórico de logs persistente e pesquisável para conformidade e auditoria

📎 Related Topics