Zum Hauptinhalt springen
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'