Die Slack-App ist eine Beta-Funktion von AppSignal Labs. Wenn Sie vor ihrer Veröffentlichung einen Slack-Notifier eingerichtet haben, siehe Einen bestehenden Notifier migrieren.
Installation
- Gehen Sie in Ihrer AppSignal-Organisation zu Notifications und wählen Sie Add new notifier aus.
- Wählen Sie Slack aus der Liste der Notifier aus.
- Wählen Sie unter Configure this integration die Option Install Slack notifier aus, um den Slack-Autorisierungsablauf zu starten.
- Autorisieren Sie in Slack die AppSignal-App für Ihren Workspace und wählen Sie den Kanal aus, in den gepostet werden soll.
- Sie werden zurück zu AppSignal geleitet, wo der Notifier unter Active notifiers erscheint.
- Wählen Sie Manage neben dem Notifier aus, um die Einrichtung abzuschließen.
Ihre Benachrichtigungseinstellungen öffnen
Konfiguration
Wählen Sie Manage neben einem Notifier auf der Seite Notifications aus, um ihn zu konfigurieren. Die Seite hat vier Abschnitte:- Settings for this notifier — der Name des Notifiers, etwa „Kritische Fehler” oder „Betriebsalarme”. Edit configuration on Slack öffnet die Einstellungen des Notifiers in Slack.
- Scope notifier to the following apps — die Apps und Umgebungen, die dieser Notifier abdeckt.
- Enable notifier for new applications — wenn aktiviert, verwendet jede App und Umgebung, die Sie später hinzufügen, standardmäßig diesen Notifier.
- Send notifications for the following events — Deploys, Errors und Performance-Traces. Errors und Performance können nach Namespace gefiltert werden: Wählen Sie die gewünschten Namespaces aus, oder heben Sie die Auswahl aller auf, um jeden Namespace abzudecken.
Wie Benachrichtigungen aussehen
Jede Slack-Benachrichtigung enthält kontextbezogene Details zum Ereignis:- Errors enthalten den Ausnahmenamen, die Nachricht, die ersten Zeilen des Backtrace, die Aktion und den Request-Pfad.
- Performance traces enthalten den Aktionsnamen, die Dauer, die Request-Methode und den Pfad.
- Deploy markers enthalten die Revision (mit einem Link zum Vergleich der Änderungen, sofern verfügbar), den Namespace und den Benutzer, der den Deploy ausgeführt hat.
- Metric alerts enthalten den Triggernamen, den aktuellen Wert, Tags und einen Link zum Alert in AppSignal.
- Heartbeat- und Process-Monitor-Alerts enthalten den Identifier und die erwartete Abschlusszeit.
- Log alerts enthalten den Triggernamen, den Schweregrad und die übereinstimmende Log-Nachricht.
Was Sie über eine Benachrichtigung tun können
Benachrichtigungen zu Error- und Performance-Incidents enthalten Steuerelemente. Deploy-Marker und Alerts werden ohne Steuerelemente gepostet.- Close incident — schließt den Incident. Die Nachricht zeigt dann „Closed by” und Ihren Namen an, und aus der Schaltfläche wird Reopen incident.
- Reopen incident — öffnet einen geschlossenen Incident erneut.
- Change assignees — öffnet einen Dialog mit den Mitgliedern dieser App. Suchen Sie nach Namen und wählen Sie so viele aus, wie Sie benötigen.
- Change severity — öffnet einen Dialog, um den Schweregrad des Incidents festzulegen: nicht eingestuft, kritisch, hoch, niedrig oder informativ.
Nachrichten bleiben aktuell
AppSignal bearbeitet eine Slack-Nachricht, wenn der Incident, den sie beschreibt, seinen Zustand, Schweregrad oder seine Zuständigen ändert. Änderungen, die Sie in AppSignal vornehmen, zählen ebenfalls. Ein Kanal liest sich dann wie der aktuelle Zustand Ihrer Apps, nicht wie eine Liste bereits bearbeiteter Alerts.Ihr Slack-Konto verknüpfen
AppSignal muss wissen, welcher AppSignal-Benutzer hinter einer Slack-Aktion steckt. Beim ersten Mal bittet AppSignal Sie, Ihr Slack-Konto zu verknüpfen, und wendet dann die von Ihnen ausgewählte Aktion an. Ihre späteren Aktionen werden sofort angewendet. Verfügbare Aktionen richten sich nach den Berechtigungen des verknüpften Benutzers. Hat der Benutzer keinen Zugriff auf die Anwendung, wird eine angeforderte Aktion abgelehnt.Berechtigungen, die AppSignal anfragt
Während der Autorisierung fragt die AppSignal-Slack-App Folgendes an:incoming-webhook— Zugriff auf den Kanal, den Sie während der Autorisierung auswählen.chat:write— Nachrichten posten und sie anschließend bearbeiten.chat:write.public— in einem öffentlichen Kanal posten, ohne die App vorher hinzuzufügen.
Einen bestehenden Notifier migrieren
Slack-Notifier, die vor Erscheinen der aktuellen Slack-App eingerichtet wurden, senden weiterhin Benachrichtigungen. Sie sind veraltet, und Sie müssen sie migrieren, um Incident-Steuerelemente und Nachrichtenaktualisierungen zu erhalten.Falls Sie die Slack-App noch migrieren müssen, wird auf der Seite Notifications ein entsprechendes Banner angezeigt. Ist das Banner nicht zu sehen und haben Sie Slack-Notifier aktiviert, nutzen Sie bereits die richtige Version.
- Wählen Sie auf der Seite Notifications neben dem Slack-Notifier Manage aus.
- Wählen Sie im Deprecation-Banner Migrate to Modern Slack aus und bestätigen Sie.
- Slack öffnet sich. Autorisieren Sie die AppSignal-App dort erneut.
- Name des Notifiers, Apps, Benachrichtigungstypen, Namespace-Filter und die Einstellung „enable for new apps” werden übernommen.
- Jeder Metrik-Alert, jeder Uptime-Monitor, jeder Heartbeat- und Process-Monitor sowie jeder Log-Alert, der den Notifier verwendet hat, wird auf den neuen umgestellt.
- Der vorherige Notifier wird entfernt.