Gerenciar monitores de navegador simples

O New Relic permite que você use o NerdGraph para criar monitores de navegador simples. Monitores de navegador simples realizam verificações automatizadas do seu aplicativo web, simulando a interação real do usuário ao carregar páginas em um ambiente de navegador completo. Este tutorial fornece exemplos de como usar a API do NerdGraph para automatizar a criação de monitores de navegador simples.

Crie um monitor de browser simples

Você pode criar um monitor de navegador simples usando a mutação syntheticsCreateSimpleBrowserMonitor.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`accountId`	Inteiro	Sim	Seu ID de conta New Relic onde o monitor será criado.
`monitor.browsers`	Matriz	Sim	Navegador(es) que o monitor usará para executar tarefas. Navegadores suportados: `CHROME` , `FIREFOX` .
`monitor.devices`	Matriz	Sim	Dispositivos que o monitor usará para executar tarefas. Dispositivos suportados: `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`monitor.locations.public`	Matriz	Sim	matriz de localização pública identificadar onde o monitor executará verificações (por exemplo, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Corda	Sim	O nome de exibição do seu monitor de navegador simples.
`monitor.period`	Enum	Sim	Com que frequência o monitor é executado? Opções: `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Corda	Sim	O tipo de tempo de execução usado pelo seu monitor. `CHROME_BROWSER` é o único valor aceito.
`monitor.runtime.runtimeTypeVersion`	Corda	Sim	A versão do tipo de tempo de execução usada pelo seu monitor. Use `LATEST` para utilizar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como `134` ou `140` também são aceitas, mas serão descontinuadas.
`monitor.runtime.scriptLanguage`	Corda	Sim	O idioma utilizado no seu monitor. `JAVASCRIPT` é o único valor aceito.
`monitor.status`	Enum	Sim	O estado do monitor. Opções: `ENABLED` (monitor ativo e realizando verificações), `DISABLED` (monitor inativo).
`monitor.uri`	Corda	Sim	A URL a ser monitorada (ex.: `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objeto	Não	Cabeçalhos HTTP personalizados para incluir na solicitação. Cada cabeçalho possui uma propriedade `name` e uma propriedade `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	Boleano	Não	Captura uma tela durante a execução da tarefa quando ocorre uma falha ou um script é executado.
`monitor.advancedOptions.responseValidationText`	Corda	Não	Texto que deve constar na resposta para que a verificação seja aprovada. Se especificado, o monitor falhará se esse texto não for encontrado no corpo da resposta.
`monitor.advancedOptions.useTlsValidation`	Boleano	Não	Se deve validar o certificado TLS/SSL. Defina como `true` para verificar a validade da cadeia SSL do certificado.
`monitor.apdexTarget`	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 {
  syntheticsCreateSimpleBrowserMonitor(
    accountId: ACCOUNT_ID
    monitor: {
      browsers: [BROWSERS]
      devices: [DEVICES]
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      status: STATUS
      uri: "MONITORED_URI"
      advancedOptions: {
        customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" }
        enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT
        responseValidationText: "VALIDATION_TEXT"
        useTlsValidation: TLS_VALIDATION
      }
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Resposta de amostra

Uma resposta bem-sucedida retorna null para erros:

{
  "data": {
    "syntheticsCreateSimpleBrowserMonitor": {
      "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.

Atualize um monitor de browser simples

Você pode atualizar um monitor de navegador simples existente usando a mutação syntheticsUpdateSimpleBrowserMonitor. Isso permite modificar a configuração de um monitor de navegador simples que já foi criado.

Parâmetro de entrada

Parâmetro	Tipo de dados	É obrigatório?	Descrição
`guid`	Corda	Sim	O GUID exclusivo da entidade do monitor que você deseja atualizar.
`monitor.browsers`	Matriz	Não	Navegador(es) que o monitor usará para executar tarefas. Navegadores suportados: `CHROME` , `FIREFOX` .
`monitor.devices`	Matriz	Não	Dispositivos que o monitor usará para executar tarefas. Dispositivos suportados: `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`monitor.locations.public`	Matriz	Não	matriz de localização pública identificadar onde o monitor executará verificações (por exemplo, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Corda	Não	O nome de exibição atualizado para o seu monitor de navegador simples.
`monitor.period`	Enum	Não	Com que frequência o monitor é executado? Opções: `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Corda	Não	O tipo de tempo de execução usado pelo seu monitor. `CHROME_BROWSER` é o único valor aceito.
`monitor.runtime.runtimeTypeVersion`	Corda	Não	A versão do tipo de tempo de execução usada pelo seu monitor. Use `LATEST` para utilizar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como `134` ou `140` também são aceitas, mas serão descontinuadas.
`monitor.runtime.scriptLanguage`	Corda	Não	O idioma utilizado no seu monitor. `JAVASCRIPT` é o único valor aceito.
`monitor.status`	Enum	Não	O estado do monitor. Opções: `ENABLED` (monitor ativo e realizando verificações), `DISABLED` (monitor inativo).
`monitor.uri`	Corda	Não	A URL a ser monitorada (ex.: `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objeto	Não	Cabeçalhos HTTP personalizados para incluir na solicitação. Cada cabeçalho possui uma propriedade `name` e uma propriedade `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	Boleano	Não	Captura uma tela durante a execução da tarefa quando ocorre uma falha ou um script é executado.
`monitor.advancedOptions.responseValidationText`	Corda	Não	Texto que deve constar na resposta para que a verificação seja aprovada. Se especificado, o monitor falhará se esse texto não for encontrado no corpo da resposta.
`monitor.advancedOptions.useTlsValidation`	Boleano	Não	Se deve validar o certificado TLS/SSL. Defina como `true` para verificar a validade da cadeia SSL do certificado.
`monitor.apdexTarget`	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 {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: ENTITY_GUID
    monitor: {
      browsers: [BROWSERS]
      devices: [DEVICES]
      locations: { public: ["LOCATION_1", "LOCATION_2"] }
      name: "YOUR_MONITOR_NAME"
      period: PERIOD
      runtime: {
        runtimeType: "RUNTIME_TYPE"
        runtimeTypeVersion: "RUNTIME_TYPE_VERSION"
        scriptLanguage: "SCRIPT_LANGUAGE"
      }
      status: STATUS
      uri: "MONITORED_URI"
      advancedOptions: {
        customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" }
        enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT
        responseValidationText: "VALIDATION_TEXT"
        useTlsValidation: TLS_VALIDATION
      }
      apdexTarget: APDEX_TARGET
    }
  ) {
    errors {
      description
      type
    }
  }
}

Resposta de amostra

Uma resposta bem-sucedida retorna null para erros:

{
  "data": {
    "syntheticsUpdateSimpleBrowserMonitor": {
      "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.

Aprimore o tempo de execução de um monitor de navegador simples.

Você pode atualizar um monitor de browser simples para usar o tempo de execução mais recente do Chrome. Recomendamos usar a versão LATEST para garantir que seu monitor permaneça 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 navegador simples como LATEST dentro de 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
`guid`	Corda	Sim	O GUID exclusivo da entidade do monitor que você deseja atualizar.
`monitor.runtime.runtimeType`	Corda	Sim	O tipo de tempo de execução. `CHROME_BROWSER` é o único valor aceito.
`monitor.runtime.runtimeTypeVersion`	Corda	Sim	A versão do runtime. Use `LATEST` para usar automaticamente a versão mais recente do Chrome (recomendado). Versões específicas mais antigas como `134` ou `140` também são aceitas, mas serão descontinuadas.
`monitor.runtime.scriptLanguage`	Corda	Sim	A linguagem de script. `JAVASCRIPT` é o único valor aceito.

Solicitação de amostra

Atualize para a versão mais recente do Chrome (recomendado):

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    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": {
    "syntheticsUpdateSimpleBrowserMonitor": {
      "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.

Exclua um monitor de navegador simples

Quando um monitor de navegador simples 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.

Esta tradução de máquina é fornecida para sua comodidade.

Gerenciar monitores de navegador simples

Crie um monitor de browser simples .css-21sua1{background:none;border:none;width:0;padding:0;}

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Atualize um monitor de browser simples

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Aprimore o tempo de execução de um monitor de navegador simples.

Importante

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Exclua um monitor de navegador simples

Crie um monitor de browser simples