O New Relic permite que você use o NerdGraph para criar monitores de verificação de certificados. O verificador de certificados monitora as datas de expiração dos certificados SSL e notifica você quando os certificados estão prestes a expirar. Este tutorial fornece exemplos de como usar a API do NerdGraph para automatizar a criação de monitores de verificação de certificados.
Crie um monitor de verificação de certificado
Você pode criar um monitor de verificação de certificado usando a mutação syntheticsCreateCertCheckMonitor. Essa mutação permite configurar o monitoramento do vencimento do certificado SSL em qualquer domínio.
Parâmetro de entrada
Parâmetro | Tipo de dados | É obrigatório? | Descrição |
|---|---|---|---|
| Inteiro | Sim | Seu New Relic onde o monitor será criado. |
| Corda | Sim | O domínio a ser monitorado para expiração do certificado (ex:
). |
| Matriz | Sim | matriz de identificadar onde o monitor executará verificações (por exemplo,
). |
| Corda | Sim | O nome de exibição do seu monitor de verificação de certificados. |
| Inteiro | Sim | Número de dias restantes até o vencimento do certificado para que seja acionada uma falha. Por exemplo, definir esse valor para 30 significa que o monitor falhará quando o certificado tiver 30 dias ou menos até expirar. |
| Enum | Sim | Com que frequência o monitor é executado? Opções:
,
,
,
,
,
,
,
,
. |
| Enum | Sim | O estado do monitor. Opções:
(monitor ativo e realizando verificações),
(monitor inativo). |
| Float | Não | O monitor Apdex destino em segundos, usado para preencher relatórios SLA. O valor padrão é de 7,0 segundos. |
Solicitação de amostra
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 } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsCreateCertCheckMonitor": { "errors": null } }}Se houver algum problema ao criar o monitor, a matriz errors conterá objetos com campos description e type explicando o que deu errado.
Atualizar um monitor de verificação de certificado
Você pode atualizar um monitor de verificação de certificado existente usando a mutação syntheticsUpdateCertCheckMonitor. Isso permite modificar a configuração de um monitor de verificação de certificado que já foi criado.
Parâmetro de entrada
Parâmetro | Tipo de dados | É obrigatório? | Descrição |
|---|---|---|---|
| Corda | Sim | O exclusivo da entidade do monitor que você deseja atualizar. |
| Corda | Não | O domínio a ser monitorado para expiração do certificado (ex:
). |
| Matriz | Não | matriz de identificadar onde o monitor executará verificações (por exemplo,
). |
| Corda | Não | O nome de exibição atualizado para o seu monitor de verificação de certificado. |
| Inteiro | Não | Número de dias restantes até o vencimento do certificado para que seja acionada uma falha. |
| Enum | Não | Com que frequência o monitor é executado? Opções:
,
,
,
,
,
,
,
,
. |
| Enum | Não | O estado do monitor. Opções:
(monitor ativo e realizando verificações),
(monitor inativo). |
| Float | Não | O monitor Apdex destino em segundos, usado para preencher relatórios SLA. O valor padrão é de 7,0 segundos. |
Solicitação de amostra
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 } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsUpdateCertCheckMonitor": { "errors": null } }}Se houver algum problema ao atualizar o monitor, a matriz errors conterá objetos com campos description e type explicando o que deu errado.
Excluir um monitor de verificação de certificado
Quando um monitor de verificação de certificado não for mais necessário, você poderá removê-lo permanentemente usando a mutação syntheticsDeleteMonitor.
Para excluir um monitor, consulte a seção Excluir monitor Sintético.