​

Observabilité des erreurs (swing positions)

​

1. Contrat errorCode

• Chaque activité d’échec exchange pertinente inclut context.errorCode (voir error-map.json).
• Les logs structurés (logError) incluent les mêmes champs : errorCode, positionId, exchangePair, activityType, spec: swing-positions/observability-errors.

​

2. errorFlags sur swingPosition

​

3. BetterStack (recommandations)

• Critique : errorFlags contient TP_EXCHANGE_ERROR_STALLED ou errorCode répété > N fois / 15 min pour un même positionId.
• Warning : errorCode = EXCHANGE_MIN_AMOUNT ou flag REPEATED_TP_EXCHANGE_ERROR.
• Réduction de bruit : ne pas alerter sur le même positionId + même errorCode plus d’une fois par heure sans variation (déduplication côté BetterStack si disponible).

​

4. Audits MongoDB (exemples)

db.swingPosition.find(
  {
    status: "RUNNING",
    $or: [
      { errorFlags: "REPEATED_TP_EXCHANGE_ERROR" },
      { errorFlags: "TP_EXCHANGE_ERROR_STALLED" }
    ]
  },
  { _id: 1, status: 1, errorFlags: 1, updatedAt: 1 }
).limit(20);

db.swingPosition.aggregate([
  { $match: { status: "RUNNING" } },
  { $project: {
      last: { $arrayElemAt: ["$activity", -1] },
      _id: 1
  }},
  { $match: { "last.type": { $in: ["TP1_EXCHANGE_ERROR", "TP2_EXCHANGE_ERROR"] } } },
  { $limit: 50 }
]);

​

5. Fichiers liés

• error-map.json — registre machine-lisible.
• etat-running.md — diagramme XState et états d’erreur RUNNING.