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	Browser(es) que o monitor usará para executar tarefas. Navegadores suportados: `CHROME` , `EDGE` , `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. `100` é o único valor aceito.
`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	Browser(es) que o monitor usará para executar tarefas. Navegadores suportados: `CHROME` , `EDGE` , `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. `100` é o único valor aceito.
`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 navegador simples para usar o ambiente de execução mais recente do 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
`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 de tempo de execução. `100` é o único valor aceito.
`monitor.runtime.scriptLanguage`	Corda	Sim	A linguagem de script. `JAVASCRIPT` é o único valor aceito.

Solicitação de amostra

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

Reduzir o desempenho de um monitor de navegador simples.

Você pode fazer o downgrade de um monitor de navegador simples 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
`guid`	Corda	Sim	O GUID exclusivo da entidade do monitor para o qual você deseja fazer o downgrade.
`monitor.runtime.runtimeType`	Corda	Sim	Defina como string vazia `""` para usar o ambiente de execução legado.
`monitor.runtime.runtimeTypeVersion`	Corda	Sim	Defina como string vazia `""` para usar o ambiente de execução legado.
`monitor.runtime.scriptLanguage`	Corda	Sim	Defina como string vazia `""` para usar o ambiente de execução legado.

Solicitação de amostra

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: { runtimeType: "", runtimeTypeVersion: "", scriptLanguage: "" }
    }
  ) {
    errors {
      description
      type
    }
  }
}

Resposta de amostra

Uma resposta bem-sucedida retorna null para erros:

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

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.

Parâmetro de entrada

Solicitação de amostra

Resposta de amostra

Reduzir o desempenho 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