Häufig gestellte Fragen
Kurze Antworten zu TaskBeacon. Die Schritte zur Einrichtung stehen in der Dokumentation; häufige Probleme mit geplanten Jobs in den Anwendungsfällen.
- Das Produkt
- Preise
- Sicherheit und Datenschutz
- Wie Pings funktionieren
- Sprachen und Werkzeuge
- Benachrichtigungen
- Datenprüfungen
Das Produkt
Was ist TaskBeacon?
Ein Dienst, der geplante Jobs überwacht. Ihr Skript sendet eine kurze Webanfrage (einen Ping), wenn es startet und wenn es endet. TaskBeacon weiß, wann jeder Lauf erwartet wird, und benachrichtigt Sie, wenn ein Job fehlschlägt, verpasst wird, sich verspätet oder ungewöhnliche Daten sendet, etwa viel weniger Zeilen als üblich. Es kann auch Websites prüfen und die Läufe von Power BI, SharePoint, dbt Cloud, Fivetran und Azure Data Factory auslesen.
Für wen ist es gedacht?
Analysten und kleine Datenteams, deren Berichte und Importe auf dem eigenen PC oder einem Server laufen, gestartet von der Windows-Aufgabenplanung, cron oder SQL Server Agent: Python, R, Stata, SAS, SPSS, PowerShell und Ähnliches. In den Anwendungsfällen sehen Sie, welche Probleme es löst.
Warum reichen die Aufgabenplanung oder cron nicht aus?
Ein Scheduler kennt nur den Exit-Code dessen, was er gestartet hat, und auch nur, wenn der Job gelaufen ist. Stata im Batchmodus endet nach einem Fehler mit 0, ein Job, der 0 Zeilen lädt, endet ebenfalls mit 0, und ein Lauf, der nie gestartet ist, hinterlässt gar keinen Code. Siehe Aufgabenplanung zeigt 0x0, aber das Skript ist fehlgeschlagen.
Was muss ich installieren?
Nichts. Das Skript macht einen HTTP-Aufruf mit curl, PowerShell oder der eigenen Bibliothek der Sprache.
Was bedeuten Failed, Missed, Late und Odd data?
Failed (fehlgeschlagen): Das Skript hat einen Fehler gemeldet. Missed (verpasst): Ein geplanter Lauf samt Karenzzeit ist ohne Ping verstrichen. Late (verspätet): Der Lauf hat begonnen und dauert viel länger als üblich. Odd data (ungewöhnliche Daten): Der Lauf ist beendet, aber eine Zahl hat eine Regel verletzt, zum Beispiel sind die Zeilen eingebrochen. Siehe Status.
Ich habe Dutzende Jobs. Lege ich sie einzeln an?
Nein. Fügen Sie unter Import jobs (Jobs importieren; im Menü neben + New job) eine Liste oder eine CSV-Datei ein, oder legen Sie Jobs über die API an.
Kann es auch Websites und APIs prüfen?
Ja. Unser Server ruft die Adresse alle 1 bis 60 Minuten auf und benachrichtigt, wenn sie nicht erreichbar oder langsam ist oder ihr SSL-Zertifikat oder ihre Domain bald abläuft. Siehe Website- und API-Prüfungen, Benachrichtigung bei Website-Ausfall und Benachrichtigung bei ablaufendem SSL-Zertifikat.
Wo sehe ich, was sich geändert hat?
Unter What's new (Neuigkeiten, auf Englisch): jede Version mit Datum und Versionsnummer, die neueste zuerst (auch als Atom-Feed). Die Version steht in der Fußzeile jeder Seite.
Preise
Was kostet es?
Kostenlos starten: Jedes Konto ist auf Free (20 Jobs), und vorerst sind alle Pro- und Team-Funktionen für alle offen, bis die bezahlten Tarife starten. Geplant für später: Free bleibt mit 20 Jobs, Benachrichtigungen per E-Mail und Slack, Regeln für die Zeilenzahl und 30 Tagen Verlauf; Pro für 9 € im Monat (100 Jobs, Website-Prüfungen jede Minute, SSL- und Domain-Benachrichtigungen, Integrationen, alle Benachrichtigungskanäle und Regeln, der Monatsbericht, 1 Status-Link, 12 Monate Verlauf); Team für 29 € im Monat (500 Jobs, gemeinsame Projekte mit beliebig vielen Kollegen und Rollen, Benachrichtigungen pro Projekt, ein Änderungsprotokoll, die API, Statusseiten ohne Branding, 24 Monate Verlauf). Ein kostenloser Tarif bleibt, und Sie erhalten mindestens 60 Tage Vorankündigung, bevor etwas Geld kostet. Siehe Preise.
Brauche ich zum Start eine Kreditkarte?
Nein. Registrieren Sie sich mit einer E-Mail-Adresse oder einem Google-Konto. Ohne Ihre ausdrückliche Zustimmung wird nichts berechnet.
Kann ich mein Geld zurückbekommen?
Ja. Bitten Sie innerhalb von 14 Tagen nach Ihrer ersten Zahlung für Pro oder Team darum, und Sie erhalten alles zurück, ohne Angabe von Gründen. Siehe die Erstattungsrichtlinie (auf Englisch).
Was passiert, wenn ich das Job-Limit erreiche?
Nichts hält an: Ihre Jobs laufen und benachrichtigen weiter. Sie können nur keinen weiteren Job hinzufügen, bis Sie einen löschen. Wenn Sie mehr brauchen, schreiben Sie vorerst an support@taskbeacon.io.
Kann ich meine Daten mitnehmen oder mein Konto löschen?
Ja, in jedem Tarif: Laden Sie alles, was wir über Sie speichern, als Datei herunter, oder löschen Sie das Konto mit allem darin, beides in den Einstellungen (Settings). Siehe Datenschutz (auf Englisch).
Sicherheit und Datenschutz
Verlassen meine Daten meinen Server?
Nein. Nur den Ping: seine Art (Start, Ende, Fehler), die Uhrzeit, die Zahlen, die Sie senden möchten (etwa eine Zeilenzahl), und bei einem Fehler die letzten 20 Zeilen der Ausgabe (oder die Fehlermeldung), die Ihr Skript sendet. Wie jeder Webserver sehen wir außerdem die sendende IP-Adresse und den User-Agent. Pro Job werden mit Free die letzten 100 Pings aufbewahrt (vorerst 1.000); siehe Datenschutz (auf Englisch).
Was, wenn die IT ausgehendes HTTPS sperrt?
Der Rechner muss eine Adresse über HTTPS erreichen. Bitten Sie die IT, diese eine Domain freizugeben; von außen muss nichts hereinkommen.
Ist die Ping-Adresse geheim?
Behandeln Sie sie wie ein Geheimnis: Wer sie hat, kann Pings an diesen einen Job senden. Sie kann nichts lesen und nicht auf Ihr Konto zugreifen. Halten Sie sie aus öffentlichen Repositorys heraus; in GitHub Actions legen Sie sie in ein Secret.
Was ist mit Fehlermeldungen und Logzeilen?
Bei einem Fehler sendet der Code aus dem Tab „Code“ den Fehler und die letzten 20 Zeilen der Ausgabe, damit die Benachrichtigung sagt, was schiefgegangen ist. Wir speichern höchstens 10 KB pro Ping. Wenn Ihre Ausgabe Passwörter oder personenbezogene Daten enthalten kann, entfernen Sie im Tab „Code“ den Haken bei Send output lines (Ausgabezeilen senden): Dann geht nur die Fehlermeldung, der Rückgabecode oder der Exit-Code mit.
Wie Pings funktionieren
Was genau ist ein Ping?
Eine Anfrage an die eigene Adresse Ihres Jobs, etwa https://taskbeacon.io/ping/<id>. /start am Ende der Adresse markiert den Start, /fail einen Fehler, und ein Exit-Code (/0, /1 …) meldet das Ergebnis. Zahlen gehen in die Query (?rows=1520) oder als JSON. Siehe Was gemeldet werden kann.
Woher weiß TaskBeacon, dass ein Lauf verpasst wurde?
Aus dem Zeitplan des Jobs (täglich, wöchentlich, monatlich oder alle N Stunden, wie in der Aufgabenplanung) und seiner Karenzzeit. Verstreicht ein geplanter Lauf samt Karenzzeit ohne Ping, wird der Job „Missed“ (verpasst). Siehe Zeitpläne.
Was, wenn der Ping selbst nicht durchkommt?
Der Code fängt den Fehler ab und wartet höchstens 10 Sekunden, sodass Ihr Job weiterläuft, als gäbe es den Ping nicht. Kommt der Abschluss-Ping nie an, erscheint der Job als „Missed“ (verpasst) oder „Late“ (verspätet), und das ist die richtige Warnung.
Was, wenn TaskBeacon selbst ausfällt?
Pings, die gesendet werden, während unser Server nicht erreichbar ist, gehen verloren, aber deshalb wird kein Job als „Missed“ (verpasst) markiert: Jeder Job macht einfach mit seinem nächsten Lauf weiter. Nach einem Ausfall von mehr als 3 Stunden erhält jedes Konto eine E-Mail darüber.
Warum endet meine cron-Zeile mit 0, obwohl der Job fehlgeschlagen ist?
Weil der letzte Befehl der Zeile das curl ist, das den Fehler meldet, und dieses gelingt. TaskBeacon erfasst den Fehler trotzdem.
Was ist das Feld Machine (Rechner)?
Der Rechner, auf dem ein Job läuft, von Ihnen am Job eingetragen (der zuletzt verwendete ist vorausgefüllt). Der Code sendet den Hostnamen nicht. Werden alle Jobs eines Rechners gleichzeitig verpasst, erhalten Sie eine Benachrichtigung für den Rechner statt einer pro Job.
Sprachen und Werkzeuge
Welche Sprachen werden unterstützt?
Python, R, Stata, SAS, SPSS, SQL Server Agent, Excel VBA, PowerShell mit der Windows-Aufgabenplanung, Batch (.bat), Node.js und Linux cron. Alles, was eine Webadresse aufrufen kann, funktioniert. SAS, SPSS, SQL Server Agent und Excel VBA sind noch nicht auf einer echten Installation getestet; sagen Sie uns, wie es gelaufen ist.
Python und R: Was verwendet der Code?
Nur die Standardbibliothek: urllib in Python, readLines in Basis-R. Bei einem Fehler sendet es die Meldung (in Python auch das Ende des Tracebacks) und beendet das Skript wie zuvor. Siehe Python und R.
Stata: Warum das Do-File in capture noisily einschließen?
Stata im Batchmodus endet mit 0, auch wenn das Do-File an einem Fehler abbricht; deshalb muss das Do-File seinen Fehler selbst abfangen und mit dem r()-Code melden. Siehe Fehler in Stata-Do-Files im Batchmodus.
SAS und SPSS?
SAS nutzt PROC HTTP und meldet einen Fehler, wenn SYSCC über 4 liegt. SPSS Statistics nutzt seine Python-3-Integration und meldet einen Fehler aus spss.Submit. Siehe SAS und SPSS.
PowerShell, Batch und die Aufgabenplanung?
Ein kleiner PowerShell- oder .bat-Wrapper startet ein beliebiges Programm und meldet seinen Exit-Code, bei einem Fehler mit den letzten 20 Zeilen der Ausgabe. Siehe PowerShell (Aufgabenplanung).
SQL Server Agent und Excel VBA?
T-SQL kann keine Webadresse aufrufen, deshalb senden zwei zusätzliche CmdExec-Jobschritte die Pings. Ein Excel-Makro nutzt MSXML2.ServerXMLHTTP und schließt Excel nach dem Lauf. Siehe SQL Server Agent und Excel VBA.
Linux cron und Node.js?
Für cron eine crontab-Zeile um Ihren Befehl. Für Node.js 18 oder neuer das eingebaute fetch, ohne Pakete. Siehe Linux cron und Node.js.
Benachrichtigungen
Wie werde ich benachrichtigt?
Per E-Mail und auf Wunsch auch in Slack, Microsoft Teams, Discord, Google Chat, ntfy oder über einen Webhook. Sofort (mit Erinnerungen, solange der Job kaputt bleibt) oder einmal am Tag. Siehe Benachrichtigungen.
Können auch Kollegen die Benachrichtigungen bekommen?
Ja. Fügen Sie einem Job bis zu 10 weitere E-Mail-Adressen hinzu; jede bestätigt einmal, bevor sie Benachrichtigungen erhält. Oder teilen Sie ein Projekt mit Kollegen. Siehe Jobs organisieren.
Werde ich mit Benachrichtigungen überflutet?
Nein. Ein Job, der ständig zwischen kaputt und OK wechselt, sendet eine Benachrichtigung „wechselt ständig den Status“ und pausiert dann für eine Stunde, ein ganzer Rechner, der verstummt, sendet eine einzige Benachrichtigung, und Sie können stattdessen eine E-Mail am Tag wählen.
Kann ich einen Job beobachten, ohne Benachrichtigungen dafür zu bekommen?
Ja. Entfernen Sie auf der Seite „Edit“ (Bearbeiten) des Jobs den Haken bei „Send alerts for this job“ (Benachrichtigungen für diesen Job senden). Er wird weiter überwacht, wechselt den Status und erscheint in History und in den Berichten, sendet aber keine E-Mail, keine Chat-Nachricht und keinen Webhook. Siehe Benachrichtigungen.
Was ist mit Feiertagen?
Tage ohne Benachrichtigung festlegen: An diesen Tagen ist nichts geplant, nichts zählt als „Missed“ (verpasst), und es gehen keine Benachrichtigungen hinaus.
Können meine Vorgesetzten die Jobs ohne Konto sehen?
Ja, mit einem schreibgeschützten Status-Link für ein Projekt (Pro und Team, vorerst für alle offen): Jobnamen, Status, der letzte Lauf und 90 Tage Verlauf, sonst nichts. Siehe Status-Link.
Datenprüfungen
Wie funktioniert die Prüfung der Zeilenzahl?
Senden Sie die Zeilenzahl mit dem Abschluss-Ping. Wenn sie zum ersten Mal ankommt, erhält der Job zwei Regeln: Ein Lauf ist „Odd data“ (ungewöhnliche Daten), wenn die Zeilen um mehr als 40 % unter den Durchschnitt der letzten normalen Läufe fallen (nach 3 solchen Läufen) oder unter 1 liegen. Beide Regeln können Sie auf der Job-Seite ändern. Siehe 0 Zeilen oder viel weniger als üblich.
Kann es mir sagen, dass die Daten veraltet sind?
Ja. Senden Sie das neueste Datum Ihrer Daten als last_date; eine Regel wie „älter als 1 Tag“ macht den Lauf „Odd data“ (ungewöhnliche Daten). Siehe Prüfung der Datenaktualität.
Kann ich eigene Zahlen oder den Ausgabetext prüfen?
Ja. Senden Sie eine beliebige Zahl (eine Summe, eine Fehleranzahl) und legen Sie eine Regel fest: unter X, über X oder fällt um mehr als X %. Ausgaberegeln machen einen Lauf „Failed“ (fehlgeschlagen), wenn seine Ausgabe Wörter wie ERROR enthält. Siehe Was gemeldet werden kann.
Schaut sich TaskBeacon dafür meine Daten an?
Nein. Es sieht nur die Zahlen, die Ihr Skript sendet. Zeilen zählen oder das neueste Datum finden geschieht in Ihrem Skript, auf Ihrem Rechner.
Eine andere Frage? Schreiben Sie an support@taskbeacon.io.