Habilitar e desabilitar atributo (Ruby)

Isto descreve as propriedades para ativar ou desativar atributo e as regras que 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.