New Relic vous permet d'utiliser NerdGraph pour créer un moniteur de vérification de certificats. Le système de monitoring des certificats suit les dates d'expiration des certificats SSL et vous avertit lorsque ceux-ci sont sur le point d'expirer. Ce tutoriel fournit des exemples d'utilisation de l'API NerdGraph pour automatiser la création d'un moniteur de vérification de certificats.
Créer un outil de monitoring de vérification de certificat
Vous pouvez créer un moniteur de vérification de certificat en utilisant la mutation syntheticsCreateCertCheckMonitor. Cette mutation vous permet de configurer monitoring de l'expiration des certificats SSL sur n'importe quel domaine.
Paramètres d'entrée
paramètres | Type de données | Est-ce obligatoire ? | Description |
|---|---|---|---|
| Entier | Oui | Votre New Relic sur lequel le moniteur sera créé. |
| Chaîne | Oui | Le domaine à monitorer pour l'expiration du certificat (par exemple,
). |
| Array | Oui | éventail d'identifiants où le moniteur effectuera des vérifications (par exemple,
). |
| Chaîne | Oui | Nom d'affichage de votre outil de monitoring des certificats. |
| Entier | Oui | Nombre de jours avant l'expiration du certificat pour déclencher une défaillance. Par exemple, si vous définissez cette valeur à 30, le moniteur échouera lorsque le certificat aura 30 jours ou moins avant son expiration. |
| Énumération | Oui | Fréquence d'exécution du moniteur. Options :
,
,
,
,
,
,
,
,
. |
| Énumération | Oui | État du moniteur. Options :
(le moniteur est actif et effectue des vérifications),
(le moniteur est inactif). |
| Virgule flottante | Non | L'Apdex cible du moniteur en secondes, utilisé pour alimenter les rapports SLA. Par défaut, 7,0 secondes. |
Demande d'échantillon
mutation { syntheticsCreateCertCheckMonitor( accountId: ACCOUNT_ID monitor: { domain: "DOMAIN" locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION period: PERIOD status: STATUS apdexTarget: APDEX_TARGET } ) { errors { description type } }}Exemple de réponse
Une réponse positive renvoie null en cas d'erreur :
{ "data": { "syntheticsCreateCertCheckMonitor": { "errors": null } }}En cas de problème lors de la création du moniteur, le éventail errors contiendra des objets avec des champs description et type expliquant ce qui s'est mal passé.
Mettre à jour un contrôleur de vérification de certificat
Vous pouvez mettre à jour un moniteur de vérification de certificat existant en utilisant la mutation syntheticsUpdateCertCheckMonitor. Cela vous permet de modifier la configuration d'un moniteur de vérification de certificats déjà créé.
Paramètres d'entrée
paramètres | Type de données | Est-ce obligatoire ? | Description |
|---|---|---|---|
| Chaîne | Oui | L'identifiant unique de l'entité du moniteur que vous souhaitez mettre à jour. |
| Chaîne | Non | Le domaine à monitorer pour l'expiration du certificat (par exemple,
). |
| Array | Non | éventail d'identifiants où le moniteur effectuera des vérifications (par exemple,
). |
| Chaîne | Non | Le nom d'affichage mis à jour pour votre moniteur de vérification de certificat. |
| Entier | Non | Nombre de jours avant l'expiration du certificat pour déclencher une défaillance. |
| Énumération | Non | Fréquence d'exécution du moniteur. Options :
,
,
,
,
,
,
,
,
. |
| Énumération | Non | État du moniteur. Options :
(le moniteur est actif et effectue des vérifications),
(le moniteur est inactif). |
| Virgule flottante | Non | L'Apdex cible du moniteur en secondes, utilisé pour alimenter les rapports SLA. Par défaut, 7,0 secondes. |
Demande d'échantillon
mutation { syntheticsUpdateCertCheckMonitor( guid: ENTITY_GUID monitor: { domain: "DOMAIN" locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION period: PERIOD status: STATUS apdexTarget: APDEX_TARGET } ) { errors { description type } }}Exemple de réponse
Une réponse positive renvoie null en cas d'erreur :
{ "data": { "syntheticsUpdateCertCheckMonitor": { "errors": null } }}En cas de problème lors de la mise à jour du moniteur, le éventail errors contiendra des objets avec des champs description et type expliquant ce qui s'est mal passé.
Supprimer un moniteur de vérification de certificat
Lorsqu'un moniteur de vérification de certificat n'est plus nécessaire, vous pouvez le supprimer définitivement à l'aide de la mutation syntheticsDeleteMonitor.
Pour supprimer un moniteur, référez-vous à la section Supprimer un moniteur Synthétique.