# Alertes Sentry en notification sur iPhone

> Les issues et alertes Sentry en notification sur votre iPhone. Une issue nouvelle ou en régression ouvre un problème ; résolue dans Sentry, elle le clôt.

Source: https://honk-honk.app/fr/guides/alertes-sentry-iphone

Connectez Sentry à Honk : une nouvelle erreur dans votre app arrive en notification sur votre iPhone, au niveau que Sentry lui a attribué. Une issue de niveau fatal devient un Klaxon continu, une erreur un Klaxon long. Quand vous résolvez l’issue dans Sentry, Honk clôt le problème par un rétablissement. Vos règles d’alerte, y compris les alertes de métriques, peuvent aussi prévenir Honk.

Le tout passe par une intégration interne Sentry, qui signe chaque envoi avec sa propre clé. Aucun SDK à modifier, rien à déployer, et les erreurs remontées par Sentry rejoignent la même boîte de réception que vos serveurs, vos paiements et vos tâches cron.

## Avant de commencer

- Un compte Honk. Honk est pour l’instant sur invitation : [demandez un accès](https://honk-honk.app/fr/demander-un-acces).
- Un projet pour l’app, dans un espace de travail dont vous êtes propriétaire ou administrateur.
- Le droit de créer des intégrations dans votre organisation Sentry.

## 1. Créer la connexion dans Honk

Dans l’app web Honk, ouvrez le projet, allez dans **Connexions** et cliquez sur **Connecter un service**. Choisissez **Sentry**, gardez le nom ou modifiez-le, puis cliquez sur **Connecter**.

Honk affiche l’**URL du webhook** de la connexion, qui commence par `https://honk-honk.app/v1/hooks/sentry/`. Copiez-la et gardez la page ouverte pour l’étape 3.

## 2. Créer une intégration interne dans Sentry

Dans Sentry, ouvrez **Settings ▸ Developer Settings ▸ Custom Integrations**, cliquez sur **Create New Integration** et choisissez **Internal Integration**. Donnez-lui un nom, par exemple « Honk », puis :

- collez l’URL de Honk dans **Webhook URL** ;
- sous **Permissions**, réglez **Issue & Event** sur **Read** ;
- sous **Webhooks**, cochez **issue** ;
- pour utiliser Honk dans vos règles d’alerte, activez **Alert Rule Action**.

Laissez **error** décoché : cette option envoie chaque événement, un par un, et Honk l’ignore. Enregistrez l’intégration.

## 3. Coller le Client Secret dans Honk

Une fois l’intégration enregistrée, Sentry affiche ses **Credentials**. Copiez le **Client Secret**, collez-le dans **Clé de signature** dans Honk et cliquez sur **Enregistrer la clé**.

Honk refuse les envois de Sentry tant que la clé n’est pas enregistrée. Ensuite, il vérifie la signature de chaque envoi et refuse ceux qui ne correspondent pas. La connexion affiche l’heure du dernier envoi, ou la dernière erreur.

_Les services connectés d’un projet Honk : Stripe, Shopify, Uptime Kuma et Sentry, chacun avec l’heure de sa dernière livraison et l’état de sa clé._

## 4. Ajouter Honk à vos règles d’alerte

Le webhook des issues couvre déjà les issues nouvelles, en régression et résolues : cette étape est donc facultative. Pour qu’une règle d’alerte prévienne Honk, ouvrez-la dans Sentry et ajoutez l’action qui envoie une notification via votre intégration. Cela vaut pour les alertes d’issue comme pour les alertes de métriques, par exemple un taux d’erreurs au-dessus d’un seuil.

Vous pouvez garder les deux : une alerte portant sur une issue arrive dans le groupe de cette issue, à côté des messages du webhook. Elle s’ajoute au même problème au lieu d’en ouvrir un second, et résoudre l’issue dans Sentry clôt ce problème.

## Ce que devient chaque événement

**Issues.** Une nouvelle issue, ou une issue repassée en non résolue (c’est ainsi que Sentry signale une régression), ouvre un problème au niveau de l’issue :

- fatal : Klaxon continu ;
- error : Klaxon long ;
- warning : Coup de klaxon appuyé ;
- info et debug : Petit coup de klaxon.

Le message reprend le titre de l’issue, l’endroit où elle s’est produite, son identifiant court et le projet Sentry, avec un lien vers l’issue. Résoudre l’issue dans Sentry envoie un rétablissement, intitulé « Resolved » suivi du titre, qui clôt le problème. Assigner ou archiver une issue ne change rien dans Honk. Chaque issue forme son propre groupe, et Sentry signale une issue une seule fois, pas à chaque événement : une erreur qui se produit 500 fois reste un seul push.

**Alertes d’issue.** Une alerte déclenchée ouvre un problème au niveau de l’événement qui l’a déclenchée. Elle rejoint le groupe de l’issue concernée : résoudre l’issue dans Sentry clôt aussi ce problème.

**Alertes de métriques.** Le seuil critical donne un Klaxon continu, le seuil warning un Coup de klaxon appuyé, et la résolution envoie un rétablissement. Une alerte forme un seul groupe, de son déclenchement à sa résolution, et une alerte warning qui passe en critical déclenche aussitôt un nouveau push.

Si vous avez activé les Activités en direct dans [Honk pour iPhone](https://honk-honk.app/fr/iphone), un Klaxon long ou un Klaxon continu peut rester sur votre écran verrouillé jusqu’au rétablissement, ou jusqu’à ce que vous le marquiez comme traité.

## Forfaits et limites

Chaque service connecté compte dans le forfait de votre espace de travail : Free en inclut 2, Pro 20 et Team 100. Les messages de Sentry comptent dans les limites quotidiennes de messages et de push du forfait, comme tous les autres ; les [tarifs](https://honk-honk.app/fr/tarifs) les détaillent.

Pour les alertes de disponibilité et d’infrastructure dans la même boîte de réception, voyez le [guide Grafana et Alertmanager](https://honk-honk.app/fr/guides/notifications-grafana-alertmanager) et le [guide Uptime Kuma](https://honk-honk.app/fr/guides/notifications-uptime-kuma). Si votre app tourne sous Laravel, le [guide des exceptions Laravel](https://honk-honk.app/fr/guides/notifications-exceptions-laravel) signale les erreurs sans Sentry, et [En finir avec la fatigue des alertes](https://honk-honk.app/fr/guides/fatigue-des-alertes) explique comment Honk ramène un problème à un seul push.
