Sidekiq 계측

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

루비 에이전트는 모든 Sidekiq 작업자에서 perform 메서드를 사용합니다. 백그라운드 작업에 대한 데이터는 APM 의 Transactions 페이지 에 표시되며, 프로세서 유형으로 Non-web transactions 를 선택하면 프로세서 트레이스와 오류가 포함됩니다.

작업 인수 캡처

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

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

• newrelic_rpm 3.12.0 or higher: attributes.include: job.sidekiq.args.*
• newrelic_rpm 3.6.9 to 3.11.x: sidekiq.capture_params: true

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

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

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

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

sidekiq.args.include 및 sidekiq.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을 시작하는 데 사용한 정확한 명령줄을 기록해 두세요.