- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
Datadog에 로그를 전송하려면 Lograge
를 사용해 파일에 기록하고 Datadog 에이전트를 통해 이 파일을 테일링합니다. 루비(Ruby)를 사용한 로깅 설정 시 예약된 속성을 고려하세요.
Lograge를 사용하면 이 예시와 같은 표준 텍스트 기반 로그 형식을 변환할 수 있습니다.
Started GET "/" for 127.0.0.1 at 2012-03-10 14:28:14 +0100
Processing by HomeController#index as HTML
Rendered text template within layouts/application (0.0ms)
Rendered layouts/_assets.html.erb (2.0ms)
Rendered layouts/_top.html.erb (2.6ms)
Rendered layouts/_about.html.erb (0.3ms)
Rendered layouts/_google_analytics.html.erb (0.4ms)
Completed 200 OK in 79ms (Views: 78.8ms | ActiveRecord: 0.0ms)
다음 JSON 형식 로그는 보다 체계적인 구조를 제공합니다.
{
"timestamp": "2016-01-12T19:15:19.118829+01:00",
"level": "INFO",
"logger": "Rails",
"method": "GET",
"path": "/jobs/833552.json",
"format": "json",
"controller": "jobs",
"action": "show",
"status": 200,
"duration": 58.33,
"view": 40.43,
"db": 15.26
}
lograge
젬을 프로젝트에 추가합니다.gem 'lograge'
# Lograge config
config.lograge.enabled = true
# This specifies to log in JSON format
config.lograge.formatter = Lograge::Formatters::Json.new
## Disables log coloration
config.colorize_logging = false
# Log to a dedicated file
config.lograge.logger = ActiveSupport::Logger.new(Rails.root.join('log', "#{Rails.env}.log"))
# This is useful if you want to log query parameters
config.lograge.custom_options = lambda do |event|
{ :ddsource => 'ruby',
:params => event.payload[:params].reject { |k| %w(controller action).include? k }
}
end
이 설정에 대한 더 자세한 정보는 Rails 애플리케이션 로그 수집, 커스터마이즈 및 관리 방법을 참조하세요.
config/initializers/lograge_rocketpants.rb
파일(프로젝트에 따라 위치는 달라질 수 있음)에서 rocket_pants
컨트롤러에 대해 Lograge를 설정하는 방법:
# Come from here:
# https://github.com/Sutto/rocket_pants/issues/111
app = Rails.application
if app.config.lograge.enabled
ActiveSupport::LogSubscriber.log_subscribers.each do |subscriber|
case subscriber
when ActionController::LogSubscriber
Lograge.unsubscribe(:rocket_pants, subscriber)
end
end
Lograge::RequestLogSubscriber.attach_to :rocket_pants
end
grape_logging
젬을 프로젝트에 추가합니다.
gem 'grape_logging'
Grape에 추가 설정을 더합니다.
use GrapeLogging::Middleware::RequestLogger,
instrumentation_key: 'grape',
include: [ GrapeLogging::Loggers::Response.new,
GrapeLogging::Loggers::FilterParameters.new ]
config/initializers/instrumentation.rb
파일을 생성하고 다음 설정을 추가합니다.
# Subscribe to grape request and log with a logger dedicated to Grape
grape_logger = Logging.logger['Grape']
ActiveSupport::Notifications.subscribe('grape') do |name, starts, ends, notification_id, payload|
grape_logger.info payload
end
로그 수집이 활성화되면 다음을 수행해 커스텀 로그 수집을 설정해 로그 파일을 테일링하고 Datadog에 전송합니다.
conf.d/
에서 ruby.d/
폴더를 생성합니다.ruby.d/
에서 conf.yaml
파일을 생성합니다. logs:
- type: file
path: "<RUBY_LOG_FILE_PATH>.log"
service: <SERVICE_NAME>
source: ruby
sourcecategory: sourcecode
## Uncomment the following processing rule for multiline logs if they
## start by the date with the format yyyy-mm-dd
#log_processing_rules:
# - type: multi_line
# name: new_log_start_with_date
# pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])
Checks
섹션 아래에서 ruby
를 찾아 로그가 성공적으로 Datadog에 전송되었는지 확인합니다.로그가 JSON 형식에 있는 경우 Datadog는 자동으로 로그 메시지를 파싱하여 로그 속성을 추출하세요. 로그 탐색기를 사용하여 로그를 확인하고 트러블슈팅합니다.
애플리케이션 성능 모니터링(APM)이 이 애플리케이션에서 활성화된 경우, APM 루비 로깅 지침을 따라 애플리케이션 로그 및 트레이스 간 연결을 향상하여 자동으로 로그에 트레이스와 스팬 ID를 추가할 수 있습니다.
가능한 경우 로그에 추가 컨텍스트(사용자, 세션, 작업 및 메트릭)를 더합니다.
단순한 문자열 메시지를 로깅하는 대신, 다음 예시에 표시된 대로 로그 해시를 사용할 수 있습니다.
my_hash = {'user' => '1234', 'button_name'=>'save','message' => 'User 1234 clicked on button saved'};
logger.info(my_hash);
해시는 JSON으로 변환되어 user
및 button_name
에 대해 분석을 수행할 수 있습니다.
{
"timestamp": "2016-01-12T19:15:18.683575+01:00",
"level": "INFO",
"logger": "WelcomeController",
"message": {
"user": "1234",
"button_name": "save",
"message": "User 1234 clicked on button saved"
}
}