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 | Navegador(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. Use
para utilizar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como
ou
também são aceitas, mas serão descontinuadas. |
| 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 | Navegador(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. Use
para utilizar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como
ou
também são aceitas, mas serão descontinuadas. |
| 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 monitor de browser com script para usar o runtime mais recente do Chrome. Recomendamos usar a versão LATEST para garantir que seu monitor se mantenha atualizado automaticamente com as versões mais recentes do Chrome.
Importante
Gerenciamento de versão do Chrome: a New Relic está fazendo a transição para um modelo de versão LATEST para runtimes do Chrome. Versões específicas do Chrome (como 134 e 140) chegarão ao fim da vida útil e apenas LATEST será mantida daqui em diante. Em 18 de agosto de 2026, os monitores que ainda estiverem em versões mais antigas do Chrome serão atualizados obrigatoriamente para a versão estável mais recente (Chrome 147 ou superior). Quando o Chrome lançar uma nova versão, ela estará disponível em monitores de browser com script como LATEST em até uma semana. Para garantir que seus monitores recebam automaticamente as atualizações e recursos mais recentes do Chrome, atualize para runtimeTypeVersion: "LATEST" antes desta data.
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 do runtime. Use
para usar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como
ou
também são aceitas, mas serão descontinuadas. |
| Corda | Sim | A linguagem de script.
é o único valor aceito. |
Solicitação de amostra
Atualize para a versão mais recente do Chrome (recomendado):
mutation { syntheticsUpdateScriptBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "CHROME_BROWSER" runtimeTypeVersion: "LATEST" 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.
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.