이 문서는 New Relic Ruby 에이전트로 속성 수집을 구성하는 방법의 예를 보여줍니다. 속성에 대한 모든 Ruby 에이전트 구성 설정 목록은 Ruby 에이전트 구성: 속성 을 참조하세요.
캡처 요청 매개변수
요청 매개변수 캡처는 기본적으로 활성화되어 있지 않습니다. 다음 구성은 기본 대상인 transaction_tracer
, transaction_events
및 error_collector
에 대한 매개변수 캡처를 켭니다. 대상을 제한하려면 특정 대상 선택 예를 참조하십시오.
Configuration:
attributes.include: request.parameters.*
요청 매개변수에는 문자열 request.parameters
접두사가 붙고 중첩 매개변수에는 해당 중첩을 반영하는 키가 있습니다. 예를 들어 프로필 아래에 내포된 위치 속성이 있는 사용자는 request.parameters.user.profile.location
키를 갖습니다.
마찬가지로 컬렉션의 구성원인 속성에는 구성원을 반영하는 인덱스가 있는 키가 있습니다. 사용자의 전화번호가 여러 개인 경우 키가 request.parameters.phone_numbers.0
, request.parameters.phone_numbers.1
등으로 표시됩니다.
요청 매개변수를 캡처하는 동안 민감한 데이터 제외
암호 또는 신용 카드 번호와 같은 요청 매개변수에서 민감한 정보를 생략하려는 상황이 있을 수 있습니다. 다음 구성을 통해 다음을 수행할 수 있습니다.
Configuration:
attributes.include: request.parameters.*attributes.exclude: [request.parameters.password, request.parameters.credit_card_no]
특정 요청 매개변수만 캡처
특정 요청 매개변수만 캡처하려면 목록을 attributes.include
에 전달하면 됩니다.
Configuration:
attributes.include: [request.parameters.user_id, request.parameters.shard_id]
캡처 요청 작업 인수
기본적으로 Resque 작업 인수는 캡처되지 않습니다. 이 기능을 활성화하려면 아래 구성을 사용하십시오.
attributes.include: job.resque.args.*
Note:
Resque 작업에 대한 인수는 위치적이며 생성된 키는 이를 반영합니다. 예를 들어 두 개의 인수를 사용하는 작업에는 job.resque.args.0
키가 있고 job.resque.args.1
Sidekiq 작업 인수 캡처
기본적으로 Sidekiq 작업 인수는 캡처되지 않습니다. 이 기능을 활성화하려면 아래 구성을 사용하십시오.
attributes.include: job.sidekiq.args.*
Note:
Sidekiq 작업에 대한 인수는 위치적이며 생성된 키는 이를 반영합니다. 예를 들어 두 개의 인수를 사용하는 작업에는 job.sidekiq.args.0
키가 있고 job.sidekiq.args.1
모든 속성 비활성화
이 예에서는 속성이 비활성화되어 있으므로 포함 및 제외 목록이 무시되고 모든 속성이 필터링됩니다.
Configuration:
attributes.enabled: falseattributes.include: request.parameters.*
Input keys:
foo, bar, request.parameters.foo, request.parameters.bar
Output for destinations:
- transaction_tracer: 없음
- error_collector: 없음
- transaction_events: 없음
- 브라우저 모니터링: 없음
특정 목적지 선택
이 예에서:
- 트랜잭션 추적에 대해 특성이 비활성화됩니다. 포함 및 제외 목록은 무시되고 이 대상에 대한 모든 속성이 필터링됩니다.
- 기본적으로 에 대한 속성도 비활성화되어 있습니다.
- 요청 매개변수(접두사
request.parameters.
)는 모든 대상에 대해 기본적으로 해제되어 있습니다.
결과적으로 추적된 오류 및 트랜잭션 이벤트에서는 bar
만 전송됩니다.
Configuration:
attributes.enabled: truetransaction_tracer.attributes.enabled: falseattributes.exclude: foo
Input keys:
foo, bar, request.parameters.foo, request.parameters.bar
Output for destinations:
- transaction_tracer: 없음
- error_collector: 막대
- transaction_events: 바
- 브라우저 모니터링: 없음
값 및 대상 선택
이 예에서는 특정 출력 대상에 대해 특정 입력 키가 선택되고 다른 대상에서는 제외됩니다.
food.fruit.banana
키는 트랜잭션 추적에서만 제외됩니다.food
및food.vegetable
키는 모든 대상에서 제외됩니다.
Configuration:
browser_monitoring.attributes.enabled: trueattributes.exclude: food*attributes.include: food.fruit.*transaction_tracer.attributes.exclude: food.fruit.banana
Input keys:
food, food.vegetable, food.fruit.apple, food.fruit.banana
Output for destinations:
- transaction_tracer: food.fruit.apple
- error_collector: food.fruit.apple, 음식.과일.바나나
- transaction_events: food.fruit.apple, 음식.과일.바나나
- browser_monitoring: food.fruit.apple, 음식.과일.바나나