Astry propose des intégrations à des solutions standard pour déclencher des incidents. Elles sont accessibles depuis l'onglet principal Organisation puis Intégrations entrantes. Pour activer une intégration vous devez être Propriétaire au sein de l'Organisation.
Une fois l'intégration activée, la plupart des intégrations reposent sur une clé d'API, à générer depuis la page de l'intégration, et à utiliser ensuite dans l'URL (ou l'adresse email) appelée par votre système.
Note : La plupart des intégrations permettent de positionner, en plus du titre et de la description de l'incident, sa priorité (de 1 à 5), ses tags (utilisés par les règles de routage et pour lier les ressources impactées) et un correlationId, utilisé pour la dé-duplication des incidents.
Elastalert / Elasticsearch / ELK
Astry peut s'interfacer avec Elasticsearch via l'utilisation de Elastalert. Ce composant est responsable de la détection d'anomalies (via l'écriture de règles de détection) et est capable d'envoyer des alertes à Astry. Cette intégration est pertinente lorsque votre système d'informations dispose d'une solution Elasticsearch (qui héberge par exemple des métriques de monitoring).
La procédure d'intégration proprement dite est décrite sur la page Intégrations entrantes puis Elastalert / ELK.
Emails
Vous avez la possibilité de déclencher des incidents en envoyant un simple email. Cette intégration peut par exemple être pertinente lorsque vos clients vous déclenchent déjà par email. Elle peut aussi être pertinente si vous disposez d'une solution de monitoring qui sait envoyer des emails (ce qui est souvent le cas), c'est alors un moyen simple d'intégrer Astry à votre système d'informations.
Le sujet de l'email devient le titre de l'incident, et son corps la description. L'adresse email de destination est construite à partir de votre clé d'API, et peut porter des paramètres optionnels : par exemple VOTRE_CLE+priority=3&tags=tag1_tag2&correlationId=abcd1234@... (les tags sont séparés par des _, et la priorité par défaut est 3).
La procédure d'intégration proprement dite est décrite sur la page Intégrations entrantes puis Emails.
Nagios / Icinga
Cette intégration n'est disponible qu'en beta pour le moment. Sur la version standard d'Astry vous pourrez donc utiliser à la place l'intégration Emails (voir ci-dessus) pour déclencher des incidents depuis Nagios/Icinga.
Prometheus
Astry peut s'interfacer avec Prometheus via le composant AlertManager. Dans ce cas les règles d'alerting sont définies au sein d'AlertManager et celui-ci déclenche des incidents sur Astry. Cette intégration est pertinente lorsque votre système d'informations dispose déjà d'une solution Prometheus.
La procédure d'intégration proprement dite est décrite sur la page Intégrations entrantes puis Prometheus.
Webhook
Le Webhook est le moyen le plus simple d'offrir une intégration à Astry pour n'importe quelle application ou solution qui sait effectuer un appel HTTP(S). Il s'agit simplement d'envoyer une requête REST avec les paramètres de l'incident à ouvrir dans le corps de la requête :
curl -XPOST https://api.astry.fr/integrations/api/20220510/alert/VOTRE_CLE \
-H "Content-Type: application/json" \
-d '{"correlationId":"MonCorrelationId","title":"Mon nouvel incident","content":"Description de l incident","priority":3,"tags":["MonTag"]}'
Les champs correlationId, title et content sont obligatoires. Les champs priority (de 1 à 5, 3 par défaut) et tags sont optionnels.
La procédure d'intégration proprement dite est décrite sur la page Intégrations entrantes puis Webhook.
Zabbix
Astry peut s'interfacer avec Zabbix (quel que soit sa version). Cette intégration est pertinente lorsque votre système d'informations dispose déjà d'une solution Zabbix.
La procédure d'intégration proprement dite est décrite sur la page Intégrations entrantes puis Zabbix, avec des instructions dédiées pour Zabbix 4 et pour Zabbix 6.
Amazon CloudWatch et Amazon SNS
Astry peut déclencher des incidents à partir de vos alarmes Amazon CloudWatch, ou de n'importe quel message publié sur un topic Amazon SNS. Ces deux intégrations sont détaillées sur la page Intégrations AWS.
Vercel
Astry peut se connecter à votre compte Vercel pour lever des incidents à partir des logs de vos projets (erreurs, réponses HTTP 5xx, échecs de déploiement, ...). Voir la page Intégration Vercel.
Téléphone
Vous pouvez aussi déclencher un incident par simple appel téléphonique, en appelant un numéro dédié et en saisissant un code à 6 chiffres. Voir la page Intégration Téléphone.
Sondes
Enfin, Astry peut lui-même surveiller vos services HTTP et lever des incidents lorsqu'ils ne répondent plus correctement. Voir la page Sondes.