• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Tutorial NerdGraph: exemplos de monitoramento de browser de agente

Aqui estão alguns exemplos de várias configurações de browser que você pode fazer com GraphQL.

Crie um novo aplicativo de browser

Você pode criar um aplicativo de browser usando nossa API NerdGraph em vez de usar a interface. A vantagem disso é que, quando chegar a hora de instrumentar seu aplicativo de browser com o New Relic, você poderá criar e recuperar programaticamente o trecho JavaScript para copiar e colar em seu aplicativo de browser.

Para saber como usar o npm para configurar para vários aplicativos, consulte Instrumentar vários aplicativos com npm.

Aqui está um exemplo de mutação para criar um novo aplicativo de browser com configurações padrão.

Mutação:

mutation CreateExampleBrowserApplication(
$accountId: Int!
$name: String!
$settings: AgentApplicationBrowserSettingsInput
) {
agentApplicationCreateBrowser(
accountId: $accountId
name: $name
settings: $settings
) {
guid
name
settings {
cookiesEnabled
distributedTracingEnabled
loaderScript
loaderType
}
}
}

Variáveis:

{
"accountId": Int!,
"name": String!,
"settings": {
"cookiesEnabled": Boolean,
"distributedTracingEnabled": Boolean,
"loaderType": AgentApplicationBrowserLoader
}
}

Recuperar o trecho JavaScript

Você pode recuperar o trecho JavaScript para copiar/colar em seu aplicativo. Observe que o trecho retornado é uma string codificada em JSON que precisará ser analisada antes de ser copiada/colada.

Consulte:

query FetchBrowserJavaScriptSnippet($guid: EntityGuid!) {
actor {
entity(guid: $guid) {
... on BrowserApplicationEntity {
guid
name
browserProperties {
jsLoaderScript
}
}
}
}
}

Variáveis:

{
"guid": EntityGuid!
}

Exemplos de configuração de monitoramento de Browser

As configurações do browser podem ser definidas através do NerdGraph. Aqui está um exemplo de mutação que altera o apdex de um aplicativo.

Mutação:

mutation UpdateBrowserApdexTarget(
$guid: EntityGuid!
$settings: AgentApplicationSettingsUpdateInput!
) {
agentApplicationSettingsUpdate(guid: $guid, settings: $settings) {
browserSettings {
browserConfig {
apdexTarget
}
}
errors {
description
errorClass
field
}
}
}

Variáveis:

{
"guid": EntityGuid!,
"settings": {
"browserConfig": {
"apdexTarget": Float
}
}
}

Para obter mais informações sobre quais configurações do browser podem ser atualizadas via NerdGraph, consulte a seguinte mutação. A documentação para cada campo pode ser encontrada no explorador NerdGraph.

Mutação:

mutation UpdateBrowserSettingsExample($guid: EntityGuid!, settings: AgentApplicationSettingsUpdateInput!) {
agentApplicationSettingsUpdate(guid: $guid, settings: $settings) {
browserSettings {
browserConfig {
apdexTarget
}
browserMonitoring {
ajax {
denyList
}
distributedTracing {
allowedOrigins
corsEnabled
corsUseNewrelicHeader
corsUseTracecontextHeaders
enabled
excludeNewrelicHeader
}
loader
privacy {
cookiesEnabled
}
}
dataManagement {
sendTransactionEventsToInternalStream
}
}
errors {
description
errorClass
field
}
}
}

Variáveis:

{
"guid": EntityGuid!,
"settings": {
"browserConfig": {
"apdexTarget": Float
},
"browserMonitoring": {
"ajax": {
"denyList": [String!]
},
"distributedTracing": {
"allowedOrigins": [String!],
"corsEnabled": Boolean,
"corsUseNewrelicHeader": Boolean,
"corsUseTracecontextHeaders": Boolean,
"enabled": Boolean,
"excludeNewrelicHeader": Boolean
}
"loader": AgentApplicationSettingsBrowserLoaderInput,
"privacy": {
"cookiesEnabled": Boolean
}
}
"dataManagement": {
"sendTransactionEventsToInternalStream": Boolean
}
}
}

Recuperar a configuração do aplicativo

Você pode recuperar a configuração do aplicativo do browser para usar com o método de instalação do pacote npm. Dependendo das suas necessidades, a configuração pode ser retornada em dois formatos diferentes:

  • uma string codificada em JSON para injeção no elemento head da sua página da web.
  • um objeto que pode ser usado como está no código-fonte do seu aplicativo.

Consulte:

query FetchBrowserConfiguration($guid: EntityGuid!) {
actor {
entity(guid: $guid) {
... on BrowserApplicationEntity {
guid
name
browserProperties {
jsConfig
jsConfigScript
}
}
}
}
}

Variáveis:

{
"guid": EntityGuid!
}

Agrupe seus dados com segmentos do browser

Você pode agrupar os resultados do monitoramento do browser por segmentos do browser para obter dados mais significativos. Em vez de fazer isso na interface, você pode fazer isso com GraphQL.

Listar segmentos

Comece listando os segmentos existentes:

{
actor {
entity(guid: "YOUR_GUID") {
... on BrowserApplicationEntity {
segmentAllowListAggregate {
segments
}
}
}
}
}

Aqui está a resposta:

"data": {
"actor": {
"entity": {
"segmentAllowListAggregate": {
"segments": [
"urlsegment1",
"urlsegment2"
]
}
}
}
}
"data": {
"actor": {
"entity": {
"segmentAllowListAggregate": {
"segments": [
"urlsegment1",
"urlsegment2"
]
}
}
}
}

Criar segmentos

Crie segmentos de browser usando a mutação agentApplicationSegmentsReplaceAllBrowserSegmentAllowList :

mutation {
agentApplicationSegmentsReplaceAllBrowserSegmentAllowList(
entityGuid: "YOUR_GUID"
allowList: { segments: ["urlsegment1", "urlsegment2", "urlsegment3"] }
) {
segments
}
}

Aqui está a resposta:

"data": {
"agentApplicationSegmentsReplaceAllBrowserSegmentAllowList": {
"segments": [
"urlsegment3",
"urlsegment2",
"urlsegment1"
]
}
}

Fixação da versão do agente do browser

A API GraphQL da New Relic fornece um método para "fixar" uma versão específica do agente New Relic Browser, garantindo que ela permaneça consistente em sua plataforma. Ao fixar uma versão, você pode evitar atualizações automáticas que possam introduzir alterações ou comportamentos inesperados. Os principais benefícios desse recurso incluem:

  • Control

    : mantenha autonomia sobre quando e como as atualizações serão aplicadas.

  • Confidence

    : certifique-se de que uma versão testada e aprovada do agente esteja sempre em execução.

  • Testability

    : teste facilmente novas versões em ambientes isolados antes de decidir atualizar.

  • Stability

    : minimize interrupções inesperadas e mantenha um comportamento consistente do aplicativo.

  • Efficiency

    : Reduza o tempo de implantação e mitigue as dificuldades de implantação.

Aqui está uma visão geral de como usar a API de fixação de versão do browser agente:

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.