Deixar a reação aos dados mais rápida com Redis (opcional)
Os dados externos usados pela estratégia chegam por padrão por **consulta periódica**. Com o Redis, o agente acorda no instante em que um novo valor chega e lê de novo na hora. O valor em si sempre vem da consulta ao BD — pelo Redis só passa o sinal de que "chegou um valor novo".
1. Qual é a sua configuração
O lado que publica (coletor) e o lado que assina (agente) precisam enxergar o mesmo Redis. Atendida essa condição, qualquer arranjo funciona.
Tudo em uma máquina — instalação própria (mais simples, grátis)
Se o coletor e o agente estão no mesmo servidor, é só instalar o Redis nele. Nada passa pela rede, então é o mais rápido, e o endereço nunca sai da máquina. A configuração padrão já escuta só em 127.0.0.1, então mesmo sem senha não fica exposto.
sudo apt install -y redis-server sudo systemctl enable --now redis-server redis-cli ping # PONG
redis://127.0.0.1:6379Tenho vários servidores — um host, rede privada
Se o coletor e o agente estão em servidores diferentes, coloque o Redis em um deles e conecte os outros. Na mesma nuvem e região, conectar pelo IP da rede privada é o mais seguro. ★ Abrir o bind em 0.0.0.0 sem senha faz o servidor ser encontrado rapidamente por scanners da internet. Se for obrigatório passar pela rede pública, use os três: senha longa + firewall + TLS (rediss://).
# /etc/redis/redis.conf bind 10.0.0.5 127.0.0.1 # ★ 0.0.0.0 금지 requirepass <긴-무작위-비밀번호> # 방화벽: 내 서버 IP 만 6379 허용
redis://:비밀번호@10.0.0.5:6379As redes são separadas — nível gratuito gerenciado
Quando o coletor e o agente estão em lugares que não se alcançam (nuvens diferentes, casa, empresa), coloque um Redis gerenciado no meio. O despertar quase não usa armazenamento, então os limites gratuitos costumam bastar.
rediss://…Outra pessoa publica — equipes e instituições enviando direto
Você não precisa usar nosso coletor. Qualquer programa pode publicar, desde que siga o nome do canal e o formato do payload. O canal é sori:data:v1: seguido do nome da tabela (sem o schema). O payload é só uma dica de cursor — mesmo que você coloque valores nele, não são usados; quem acorda roda a própria consulta de novo.
PUBLISH sori:data:v1:fear_greed '{"v":1,"last":1757462400000,"n":1}'2. Ordem para ativar — os três lugares precisam bater
Se faltar qualquer um, roda por consulta periódica **sem erro**. Os valores continuam corretos e só o atraso aumenta, então é fácil não perceber que nunca foi ativado.
Lado que publica — informe o endereço ao coletor
O coletor publica depois de inserir as novas linhas. Sem endereço, ele pula a publicação e registra isso no resultado da execução.
# ~/soritrading-fetchers/.env SORI_WAKE_REDIS_URL=redis://127.0.0.1:6379
Lado que assina — salve o slot no agente
Na web, informe o alias e o endereço e clique em [Verificar conexão]: aquele dispositivo responde na hora se realmente conecta. O endereço fica salvo só no keystore daquele dispositivo — não vai para o servidor nem aparece nos logs.
Declaração — qual tabela escutar em qual slot
Mais abaixo na mesma tela, em [Declarações de datasets], mude o modo para redis e preencha o nome do slot e o nome da tabela. O nome da tabela é necessário porque o nome do canal vem dele.
mode: redis · redisAlias: main · tableName: fear_greed
- O Redis é só um despertador. Se uma mensagem se perder (durante um reinício do agente, por exemplo), a próxima consulta periódica alcança, então os valores não ficam errados.
- Não é possível assinar pelo endpoint REST de provedores serverless. Use o endereço TCP que começa com redis:// ou rediss://.
- Se o nível gratuito derrubar conexões ociosas, tudo pode passar a rodar silenciosamente só por consulta periódica. O agente detecta a queda e reconecta, mas se cair com frequência, esse nível não serve para este uso.
- Nomes de slot e aliases de BD são espaços de nomes separados. Mesmo que os dois sejam 'main', apontam para servidores diferentes.
- O endereço de conexão fica salvo só no dispositivo do agente. Nossos servidores não estão nesse caminho e não recebem o endereço, nem ao salvar nem ao consultar.
- Excluir um slot não corta na hora uma assinatura já aberta; ela termina na próxima reconexão. Enquanto isso, os valores são os mesmos, só com menos atraso.
A documentação completa está aqui — Guia de uso