n8n

Le package npm n8n-nodes-snaplogs ajoute deux nodes dans n8n : SnapLogs (actions) et SnapLogs Trigger.

Installation

Chemin officiel — community node, pas de terminal.

1. Ouvre n8n.
2. Settings → Community nodes (Paramètres → Community nodes).
3. Clique Install.
4. Saisis n8n-nodes-snaplogs.
5. Valide, puis Install.
6. Les nodes SnapLogs et SnapLogs Trigger apparaissent dans le panel.

Mise à jour

1. Settings → Community nodes
2. Sur n8n-nodes-snaplogs, clique Update

Si n8n affiche The specified package does not contain any nodes, le package installé est antérieur à 0.1.1. Clique Update.

Credential

Credentials → Add credential → SnapLogs API

| Champ | Quoi mettre | |---|---| | API Key | Clé projet : app.snaplogs.pro → Settings → API Keys | | Endpoint | https://app.snaplogs.pro (sans / final) |

SnapLogs envoie x-snaplogs-key. Le test de credential appelle GET /api/v1/project. /health est public : ne l’utilise pas pour valider une clé.

Node SnapLogs

| Resource | Operation | Usage | |---|---|---| | Feedback | Create / Get / List / Update | Inbox SnapLogs | | Event | Ingest | Event catalogue (agents, billing, etc.) | | Log | Ingest | Une ligne (workflow en cours) | | Log | Import | Lot — max 500 (fichier, items n8n) | | Project | Get | Métadonnées du projet lié à la clé | | Health | Check | Ping API |

Importer beaucoup de logs

1. En amont : Read Binary File / Code / HTTP qui sort des items avec message (ou msg, text, error).
2. Node SnapLogs → Resource Log → Operation Import.
3. Laisse Use Incoming Items coché.
4. Source par défaut : n8n (ou other pour un dump applicatif).
5. Create Feedback on Error : off sauf si tu veux des tickets (plafonné à 20).

Sans items : décoche Use Incoming Items et colle un JSON [{ "message": "…", "level": "error" }] ou un dump texte (une ligne = un log).

Même import sans n8n : dans l’app, Capturer → n8n → Importer des logs (fichier .json / .jsonl / .txt / .log).

API : POST /api/v1/logs/import — voir Importer des logs.

Node SnapLogs Trigger

• Webhook — temps réel (feedback.created, status_changed, agent.error, n8n.execution_failed).
• Poll — si SnapLogs ne peut pas joindre ton n8n.

Brancher l’instance n8n depuis SnapLogs

Dans app.snaplogs.pro → Capturer → n8n :

1. Base URL de l’instance + API key n8n.
2. Coche les workflows à surveiller.
3. Sync maintenant tire les exécutions en erreur vers sl_agent_logs.

Ça complète le community node : sync depuis n8n vers SnapLogs, le node pousse vers SnapLogs.

Premier scenario de test

1. Credential SnapLogs API (test vert).
2. Node SnapLogs → Health → Check → Execute.
3. Node SnapLogs → Log → Ingest : level=info, message=hello from n8n.
4. Dans SnapLogs, Capturer → n8n : la ligne apparaît sous Logs récents.