Bevor Sie Prozessmonitor-Events an AppSignal senden, müssen Sie zunächst einen Prozessmonitor in AppSignal erstellen.
Sie können Prozessmonitor-Events an AppSignal senden, indem Sie HTTP-POST-Anfragen an die AppSignal-API mit einem beliebigen HTTP-Client durchführen. Die Beispiele auf dieser Seite stellen einen Beispiel-cURL-Befehl sowie die rohe HTTP-Methode und URL zur Verwendung mit jedem HTTP-Client Ihrer Wahl bereit.
In den folgenden Beispielen ersetzen Sie YOUR-APP-LEVEL-API-KEY durch den AppSignal Push-API-Schlüssel auf App-Ebene für Ihre App, den Sie in den Push & Deploy-Einstellungen Ihrer Anwendung finden, und YOUR-PROCESS-MONITOR-IDENTIFIER durch den Bezeichner des Prozessmonitors, an den Sie Events senden möchten.
Die Process Monitoring API verwendet weiterhin check_ins in Endpoint-URLs für
Kompatibilität mit bestehenden Integrationen.
Senden von Cron-Prozessmonitor-Events
Cron-Prozessmonitore werden verwendet, um die Ausführung geplanter Jobs wie Cronjobs zu überwachen. AppSignal erwartet den Empfang eines Finish-Cron-Prozessmonitor-Events gemäß seinem konfigurierten Zeitplan und benachrichtigt Sie, wenn kein Finish-Cron-Prozessmonitor-Event innerhalb seiner konfigurierten maximalen Dauer empfangen wird.
Zusätzlich können Sie Start-Cron-Prozessmonitor-Events an AppSignal senden, um zu benachrichtigen, dass ein Cron-Prozessmonitor-Event gestartet wurde, sodass Sie die Dauer Ihrer Cronjobs messen können.
Finish-Cron-Prozessmonitor
Um AppSignal zu benachrichtigen, dass ein Cronjob erfolgreich beendet wurde, senden Sie eine POST-Anfrage an die AppSignal-API mit den folgenden URL-Query-Parametern:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER'
AppSignal benachrichtigt Sie, wenn kein Finish-Cron-Prozessmonitor-Event innerhalb der konfigurierten maximalen Dauer des Cron-Prozessmonitors empfangen wird.
Start-Cron-Prozessmonitor
Das Senden eines Start-Cron-Prozessmonitor-Events ist vollständig optional. Dadurch können Sie die Dauer Ihrer Cronjobs messen.
Um AppSignal zu benachrichtigen, dass ein Cronjob gestartet wurde, senden Sie eine POST-Anfrage an die AppSignal-API mit den folgenden URL-Query-Parametern:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER' \
-d 'kind=start'
Senden eines Digest
Beim Senden eines Start-Cron-Prozessmonitors empfehlen wir, sowohl für die Start- als auch für die Finish-Events einen Digest zu senden. Der Digest ist ein beliebiger Wert, der zur Korrelation der Start- und Finish-Cron-Prozessmonitor-Events verwendet wird. Er sollte für beide, das Start- und das Finish-Event, gleich sein und für jedes Paar von Start- und Finish-Events einzigartig sein.
Das Senden eines Digest ist optional, wird aber beim Senden eines Start-Cron-Prozessmonitor-Events dringend empfohlen, da es sicherstellt, dass die Start- und Finish-Events korrekt korreliert werden.
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/cron' \
... \
-d 'digest=abc123'
Senden von Heartbeat-Prozessmonitor-Events
Heartbeat-Prozessmonitore werden verwendet, um die Verfügbarkeit eines Prozesses zu überwachen, der kontinuierlich laufen sollte, wie z. B. eine Server-Anwendung oder ein Background-Job-Prozessor. AppSignal erwartet, kontinuierlich Heartbeat-Prozessmonitor-Events zu empfangen, und benachrichtigt Sie, wenn kein Heartbeat-Prozessmonitor-Event innerhalb seiner konfigurierten maximalen Dauer empfangen wird.
Um ein Heartbeat-Prozessmonitor-Event an AppSignal zu senden, senden Sie eine POST-Anfrage an die AppSignal-API mit den folgenden URL-Query-Parametern:
curl -D - -X POST -G 'https://appsignal-endpoint.net/check_ins/heartbeats' \
-d 'api_key=YOUR-APP-LEVEL-API-KEY' \
-d 'identifier=YOUR-PROCESS-MONITOR-IDENTIFIER'