• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Sidekiq 계측

웹 애플리케이션 자체 외에도 New Relic Ruby 에이전트(버전 3.6.0 이상)는 자동으로 Sidekiq 작업을 계측할 수 있습니다. 작업자에 계측 라이브러리를 포함할 필요가 없습니다.

Ruby 에이전트는 모든 Sidekiq 작업자에서 perform 메서드를 계측합니다. 백그라운드 작업에 대한 데이터는 트랜잭션 유형으로 웹이 아닌 트랜잭션 을 선택하여 트랜잭션 추적 및 오류와 함께 APM의 트랜잭션 페이지 에 나타납니다.

작업 인수 캡처

Ruby 에이전트 버전 3.6.9부터 트랜잭션 추적 및 추적된 오류에서 Sidekiq 작업 인수를 캡처하도록 Ruby 에이전트를 선택적으로 구성할 수 있습니다. 이것은 실패한 작업을 재현하려고 할 때 특히 유용할 수 있습니다.

작업 인수에 민감한 정보가 포함된 경우 기본적으로 이 기능은 꺼져 있습니다. 이 기능을 활성화하려면 에이전트 버전에 맞게 newrelic.yml 을 편집하십시오.

  • newrelic_rpm 3.12.0 이상 : attributes.include: job.sidekiq.args.*
  • newrelic_rpm 3.6.9 - 3.11.x : sidekiq.capture_params: true

이 기능은 HTTP 요청 매개변수가 웹 요청에 대한 트랜잭션 추적 및 추적된 오류에서 캡처되는지 여부를 제어하는 일반 capture_params 최상위 설정과 다릅니다. 이 두 가지 설정을 독립적으로 구성할 수 있습니다.

특정 작업 인수 포함 또는 제외

Ruby 에이전트 버전 9.5.0부터 위에 설명된 대로 Sidekiq 작업 인수를 캡처하도록 구성된 에이전트 인스턴스는 New Relic에 보고되는 인수를 세부적으로 제어하기 위해 특정 인수를 포함하거나 제외하도록 추가로 구성할 수 있습니다.

:'sidekiq.args.include' 구성 옵션은 전체적으로 허용 목록 역할을 하는 문자열 배열로 설정할 수 있습니다. 전체 정규식 지원을 위해 해당 문자열 각각은 Regexp.new 에 전달됩니다. 해시인 작업 인수의 경우 해시의 키가 포함 패턴 중 하나와 일치하면 키와 해당 값이 모두 포함됩니다. 스칼라 인수의 경우 스칼라의 문자열 표현은 캡처할 포함 패턴 중 하나와 일치해야 합니다.

:'sidekiq.args.exclude' 옵션도 비슷하게 작동합니다. 패턴을 생성하기 위해 각각 Regexp.new 에 전달될 문자열 배열로 설정할 수 있습니다. 이러한 패턴은 원하지 않는 작업 인수에 대한 거부 목록 역할을 합니다. 제외 패턴과 일치하는 모든 해시 키, 해시 값 또는 스칼라는 제외됩니다(New Relic으로 전송되지 않음).

sidekiq.args.includesidekiq.args.exclude(newrelic_rpm 9.5.0 이상)을 구성합니다.

newrelic.yml 예:

:'sidekiq.args.include' 또는 :'sidekiq.args.exclude' 배열의 모든 문자열은 정규 표현식으로 변환됩니다. Ruby 정규식 지원 에 대한 지식을 활용할 수 있지만 필수는 아닙니다. 정규식 구문을 사용하지 않으면 부정확한 일치가 수행되고 "Fortune" 문자열은 "Fortune 500" 및 "Fortune and Glory"와 모두 일치합니다. 정확히 일치하려면 정규식 앵커를 사용하세요.

# Include any argument whose string representation matches either "apple" or "banana"
# The "apple" pattern will match both "green apple" and "red apple"
sidekiq.args.include:
- apple
- banana
# Exclude any arguments that match either "grape", "orange", or "pear"
sidekiq.args.exclude:
- grape
- orange
- pear
# Exclude any argument that is a 9 digit number
sidekiq.args.exclude:
- '\d{9}'
# Include anything that starts with "blue" but exclude anything that ends in "green"
sidekiq.args.include
- '^blue'
sidekiq.args.exclude
- 'green$'

Sidekiq 작업 문제 해결

작업이 모니터링되지 않는 것으로 나타나면 작업자가 시작할 때 생성된 newrelic_agent.log 파일을 검토하십시오. 에이전트가 Sidekiq를 감지하고 서버와 통신하는지 여부를 나타내야 합니다. 지원이 필요한 경우 Sidekiq를 시작하는 데 사용한 정확한 명령줄을 기록해 두십시오.

Copyright © 2024 New Relic Inc.

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