New Relic permite que você use o NerdGraph para criar um script de monitoramento de navegador. monitor de navegador com script executa código JavaScript personalizado em um ambiente de navegador real, permitindo simular interações complexas do usuário e fluxo de trabalho em várias etapas. Este tutorial fornece exemplos de como usar a API do NerdGraph para automatizar a criação de um script de monitoramento de navegador.
Criar um script de monitoramento de navegador
Você pode criar um script monitor de browser com usando a mutação syntheticsCreateScriptBrowserMonitor. Essa mutação permite configurar um monitoramento personalizado por script que executa seu código JavaScript em um navegador.
Parâmetro de entrada
Parâmetro | Tipo de dados | É obrigatório? | Descrição |
|---|---|---|---|
| Inteiro | Sim | Seu New Relic onde o monitor será criado. |
| Matriz | Sim | Browser(es) que o monitor usará para executar tarefas. Navegadores suportados:
,
,
. |
| Matriz | Sim | Dispositivos que o monitor usará para executar tarefas. Dispositivos suportados:
,
,
,
,
. |
| Matriz | Sim | matriz de identificadar onde o monitor executará verificações (por exemplo,
). |
| Corda | Sim | O nome de exibição do seu monitor de browser com script. |
| Enum | Sim | Com que frequência o monitor é executado? Opções:
,
,
,
,
,
,
,
,
. |
| Corda | Sim | O tipo de tempo de execução usado pelo seu monitor.
é o único valor aceito. |
| Corda | Sim | A versão do tipo de tempo de execução usada pelo seu monitor.
é o único valor aceito. |
| Corda | Sim | O idioma utilizado no seu monitor.
é o único valor aceito. |
| Corda | Sim | O código JavaScript que o monitor executa. Este texto deve ser em formato simples, não codificado em base64. O script pode usar as APIs Selenium WebDriver para controlar o navegador. |
| Enum | Sim | O estado do monitor. Opções:
(monitor ativo e realizando verificações),
(monitor inativo). |
| Boleano | Não | Captura uma tela durante a execução da tarefa quando ocorre uma falha ou um script é executado. |
| 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 { syntheticsCreateScriptBrowserMonitor( accountId: ACCOUNT_ID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } script: "SCRIPT_CONTENT" status: STATUS advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsCreateScriptBrowserMonitor": { "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 script com do monitor do browser
Você pode atualizar um script existente de monitor de browser com usando a mutação syntheticsUpdateScriptBrowserMonitor. Isso permite modificar a configuração de um script de monitor de navegador 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. |
| Matriz | Não | Browser(es) que o monitor usará para executar tarefas. Navegadores suportados:
,
,
. |
| Matriz | Não | Dispositivos que o monitor usará para executar tarefas. Dispositivos suportados:
,
,
,
,
. |
| 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 browser com script. |
| Enum | Não | Com que frequência o monitor é executado? Opções:
,
,
,
,
,
,
,
,
. |
| Corda | Não | O tipo de tempo de execução usado pelo seu monitor.
é o único valor aceito. |
| Corda | Não | A versão do tipo de tempo de execução usada pelo seu monitor.
é o único valor aceito. |
| Corda | Não | O idioma utilizado no seu monitor.
é o único valor aceito. |
| Corda | Não | O código JavaScript que o monitor executa. Este texto deve ser em formato simples, não codificado em base64. |
| Enum | Não | O estado do monitor. Opções:
(monitor ativo e realizando verificações),
(monitor inativo). |
| Boleano | Não | Captura uma tela durante a execução da tarefa quando ocorre uma falha ou um script é executado. |
| 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 { syntheticsUpdateScriptBrowserMonitor( guid: ENTITY_GUID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } script: "SCRIPT_CONTENT" status: STATUS advancedOptions: { enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "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.
Atualize o tempo de execução do script do monitor do navegador.
Você pode atualizar um script de monitor de navegador para usar o ambiente de execução mais recente Chrome 100+. Isso garante que seu monitor utilize as atualizações mais recentes de recursos e segurança do navegador.
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 | Sim | O tipo de tempo de execução.
é o único valor aceito. |
| Corda | Sim | A versão de tempo de execução.
é o único valor aceito. |
| Corda | Sim | A linguagem de script.
é o único valor aceito. |
Solicitação de amostra
mutation { syntheticsUpdateScriptBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "CHROME_BROWSER" runtimeTypeVersion: "100" scriptLanguage: "JAVASCRIPT" } } ) { errors { description type } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "errors": null } }}Se houver algum problema ao atualizar o tempo de execução do monitor, a matriz errors conterá objetos com campos description e type explicando o que deu errado.
Rebaixar o tempo de execução do script do navegador do monitor
Você pode fazer o downgrade de um script monitor de browser com para usar um ambiente de execução legado. Isso pode ser necessário por motivos de compatibilidade, mas observe que os runtimes legados chegarão ao fim de sua vida útil em 22 de outubro de 2024.
Importante
Os ambientes de execução legados estão obsoletos e chegarão ao fim de sua vida útil em 22 de outubro de 2024. Não é recomendável fazer o downgrade para versões de tempo de execução legadas, exceto em casos de necessidade temporária de compatibilidade.
Parâmetro de entrada
Parâmetro | Tipo de dados | É obrigatório? | Descrição |
|---|---|---|---|
| Corda | Sim | O exclusivo da entidade do monitor para o qual você deseja fazer o downgrade. |
| Corda | Sim | Defina como string vazia
para usar o ambiente de execução legado. |
| Corda | Sim | Defina como string vazia
para usar o ambiente de execução legado. |
| Corda | Sim | Defina como string vazia
para usar o ambiente de execução legado. |
Solicitação de amostra
mutation { syntheticsUpdateScriptBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "", runtimeTypeVersion: "", scriptLanguage: "" } } ) { errors { description type } }}Resposta de amostra
Uma resposta bem-sucedida retorna null para erros:
{ "data": { "syntheticsUpdateScriptBrowserMonitor": { "errors": null } }}Se houver algum problema ao fazer o downgrade do tempo de execução do monitor, a matriz errors conterá objetos com campos description e type explicando o que deu errado.
Excluir um script do monitor do navegador
Quando um script monitor de browser com não for mais necessário, você pode removê-lo permanentemente usando a mutação syntheticsDeleteMonitor.
Para excluir um monitor, consulte a seção Excluir monitor Sintético.