Habilitar e desabilitar atributo (Ruby)

Isto descreve as propriedades para ativar ou desativar o atributo e as regras que a New Relic usa ao determinar qual atributo incluir ou excluir para um destino. Isso também inclui um resumo das propriedades do agente Ruby que foram descontinuadas ou removidas com o lançamento do atributo do agente New Relic.

Propriedades

Use as seguintes propriedades para ativar ou desativar o atributo:

Tipo	Boleano
Padrão	`true`
Variável ambiental	`NEW_RELIC_ATTRIBUTES_ENABLED`

Se true, habilita a captura de atributo para todos os destinos.

Tipo	Boleano
Padrão	(Dinâmico)
Variável ambiental	`NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED`

Se true, o agente captura o atributo de .

Tipo	Matriz
Padrão	`[]`
Variável ambiental	`NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE`

Prefixo de atributo para excluir da coleta de erros. Permite * como curinga no final.

Para evitar a coleta de mensagens de erro , use a configuração strip_exception_messages .

Regras de atributo

A New Relic segue essas regras ao determinar qual atributo incluir ou excluir para um destino.

O campo attributes.enabled supera todas as outras configurações. Quando false, nenhum atributo será reportado à New Relic.

Exemplo de configuração:

attributes.enabled: false
    attributes.include: foo, bar
    transaction_tracer.attributes.enabled: true

Exemplo de saída:

Keys passed in: foo, bar, baz
    Keys included for all destinations:
    Keys excluded for all destinations: foo, bar, baz

As sinalizações YOUR_DESTINATION.attributes.enabled têm precedência sobre as chaves de inclusão e exclusão.

Exemplo de configuração:

transaction_tracer.attributes.enabled: false
    attributes.include: one, two
    transaction_tracer.attributes.include: three, four

Exemplo de saída:

Keys passed in: one, two, three, four
    Keys included for transaction traces:
    Keys excluded for transaction traces: one, two, three, four

Se um destino estiver habilitado, todos os atributos do usuário serão enviados para esse destino por padrão.

Note: Todos os atributos do usuário são padronizados como true. No entanto, por padrão, os parâmetros de solicitação estão desabilitados para todos os destinos.

Exemplo de configuração:

attributes.enabled: true
    attributes.exclude: baz

Exemplo de saída:

Keys passed in: foo, bar, baz
    Keys included: foo, bar
    Keys excluded: baz

Se a mesma chave estiver listada nas listas de inclusão e exclusão, então o atributo com a chave especificada será excluído.

Exemplo de configuração:

attributes.enabled: true
    attributes.include: foo, bar
    attributes.exclude: nerd, bar

Exemplo de saída:

Keys passed in: foo, bar, nerd
    Keys included: foo
    Keys excluded: nerd, bar

As chaves diferenciam maiúsculas de minúsculas.

Exemplo de configuração:

attributes.enabled: true
    attributes.exclude: username, UsErNaMe

Exemplo de saída:

Keys passed in: username, Username, USERNAME, UsErNaMe, userNAME
    Keys included: Username, USERNAME, userNAME
    Keys excluded: username, UsErNaMe

Você pode usar um asterisco * no final de uma chave como curinga. Isso corresponderá a um conjunto de atributo com o mesmo prefixo.

Exemplo de configuração:

attributes.enabled: true
    attributes.include: custom*
    attributes.exclude: request.parameters.*

Exemplo de saída:

Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: custom, custom.key1, custom.key2
    Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar

Se vários atributos de inclusão ou exclusão afetarem a mesma chave, a configuração mais específica terá prioridade.

Exemplo de configuração:

attributes.enabled: true
    attributes.include: request.parameters.foo
    attributes.exclude: request.parameters.*

Exemplo de saída:

Keys passed in: request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: request.parameters.foo
    Keys excluded: request.parameters., request.parameters.bar

Se o atributo include ou exclude for especificado em um destino, ele afetará apenas esse destino.

Exemplo de configuração:

attributes.include: foo
    transaction_events.attributes.exclude: foo

Exemplo de saída:

Keys passed in: foo
    Keys included for transaction events:
    Keys included for other destinations: foo
    Keys excluded for transaction events: foo

Propriedades relacionadas ao URI

Por padrão, o agente Ruby reporta URIs (Uniform Resource Identifir) para o New Relic em vários locais diferentes, incluindo os seguintes destinos:

O atributo request.uri do evento de erro
O atributo http.url do evento span
O atributo url do rastreamento SQL lento
O atributo uri de segmentos de solicitação externa

A New Relic recomenda que esses URIs sejam relatados, pois eles podem conter informações úteis de depuração. Se seus URIs contiverem dados confidenciais que você não deseja relatar, como endereços de e-mail ou IDs de contas, você poderá desativar os relatórios de URI. Para desativar o relatório de URI, adicione qualquer um dos nomes de atributo acima à lista attributes.exclude .

Por exemplo, adicionar a seguinte chave ao seu arquivo de configuração impedirá que o agente relate qualquer uma das propriedades relacionadas ao URI:

attributes.exclude: uri

Propriedades obsoletas e removidas

As propriedades a seguir foram descontinuadas ou removidas. Mude para a nova configuração de atributo para essas propriedades ao atualizar seu agente Ruby.

Deprecated property	New property	Removed Version
`capture_params`	`attributes.include: request.parameters.*`	N/A
`resque.capture_params`	`attributes.include: job.resque.args.*`	9.0.0
`sidekiq.capture_params`	`attributes.include: job.sidekiq.args.*`	9.0.0
`transaction_tracer.capture_attributes`	`transaction_tracer.attributes.enabled`	9.0.0
`error_collector.capture_attributes`	`error_collector.attributes.enabled`	9.0.0
`browser_monitoring.capture_attributes`	`browser_monitoring.attributes.enabled`	9.0.0
`analytics_events.capture_attributes`	`transaction_events.attributes.enabled`	9.0.0

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

Habilitar e desabilitar atributo (Ruby)

Propriedades

attributes.enabled

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

attributes.exclude

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

error_collector.attributes.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

attributes.include

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

Regras de atributo

O nível raiz tem precedência para ativado.

O destino ativado tem precedência sobre inclusão e exclusão.

O atributo será incluído se o destino estiver habilitado.

Excluir sempre substitui incluir.

As chaves diferenciam maiúsculas de minúsculas.

Use `\*` para curingas.

A configuração mais específica de uma chave tem prioridade.

Incluir ou excluir afeta o destino específico.

Propriedades relacionadas ao URI

Propriedades obsoletas e removidas

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

Habilitar e desabilitar atributo (Ruby)

Propriedades.css-21sua1{background:none;border:none;width:0;padding:0;}

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

attributes.exclude

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

error_collector.attributes.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

attributes.include

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

Regras de atributo

O nível raiz tem precedência para ativado.

O destino ativado tem precedência sobre inclusão e exclusão.

O atributo será incluído se o destino estiver habilitado.

Excluir sempre substitui incluir.

As chaves diferenciam maiúsculas de minúsculas.

Use \* para curingas.

A configuração mais específica de uma chave tem prioridade.

Incluir ou excluir afeta o destino específico.

Propriedades relacionadas ao URI

Propriedades obsoletas e removidas

Propriedades

Use `\*` para curingas.