Zum Hauptinhalt springen
Minütliche Probes sind ein Mechanismus, um periodisch benutzerdefinierte Metriken an AppSignal zu senden. In minütlichen Intervallen ab dem Zeitpunkt, an dem die Probe erstellt wurde, kann eine benutzerdefinierte Funktion aufgerufen werden, in der Sie Metriken erfassen und an AppSignal senden können. Funktionen minütlicher Probes werden asynchron ausgeführt. Ab Version 2.3.0 können Sie minütliche Probes vollständig mit der Konfigurationsoption enableMinutelyProbes aktivieren oder deaktivieren.

Probes erstellen

Wenn Sie benutzerdefinierte Metriken aus Ihrer App verfolgen müssen, können Sie eigene Probe(s) hinzufügen. Um eine Probe zu registrieren, müssen Sie die Methode probes.register() mit zwei Argumenten aufrufen: einem Probe-Namen und einer anonymen Funktion, die einmal pro Minute aufgerufen wird.
const meter = appsignal.metrics();
const probes = meter.probes();

// the callback is fired once every minute from when
// `register` is called
probes.register("database", () => {
  meter.setGauge("database_size", 10);
});
Um sicherzustellen, dass alle minütlichen Probes rechtzeitig ausgeführt werden, ist es wichtig, den Event-Loop innerhalb eines Probe-Callbacks nicht für längere Zeit zu blockieren.

Standard-Probes überschreiben

Standardmäßig konfiguriert @appsignal/nodejs eine minütliche Probe, die Node.js V8 Heap-Statistiken verfolgt. Um diese Probe zu deaktivieren, verwenden Sie probes.unregister():
const probes = appsignal.metrics().probes();

probes.unregister("v8_stats");
Vor Version 2.3.0 ist probes.unregister() nicht verfügbar. In Versionen vor 2.3.0 können Sie die Konfigurationsoption enableMinutelyProbes verwenden, um die Standard-Probe zu deaktivieren.