호스트

호스트에서 실행 중인 에이전트에 대해 이 점검을 구성하려면:

1. tomcat.d/conf.yaml 파일을 Agent 설정 디렉터리 루트에 있는 conf.d/ 폴더에서 수정하여 Tomcat 메트릭과 로그를 수집하세요. 사용 가능한 모든 설정 옵션은 샘플 tomcat.d/conf.yaml에서 확인할 수 있습니다.

2. 에이전트를 재시작하세요.

모든 JMX 기반 점검에서 사용할 수 있는 구성 옵션 목록은 JMX 점검 설명서를 참조하세요.

메트릭 목록

conf 파라미터는 연동에서 수집할 지표의 목록입니다. 두 개의 키만 허용됩니다.

• include (필수): 필터 사전입니다. 이 필터와 일치하는 모든 속성은 exclude 필터와도 일치하지 않는 한 수집됩니다(아래 참조).
• exclude (옵션): 필터 사전입니다. 이 필터와 일치하는 속성은 수집되지 않습니다.

주어진 bean에 메트릭은 다음과 같은 방식으로 태그가 지정됩니다.

mydomain:attr0=val0,attr1=val1

이 예제에서 메트릭은 mydomain (또는 bean 내부의 속성에 따라 일부 변형)이며 attr0:val0, attr1:val1, domain:mydomain 태그가 있습니다.

include 키에 카멜(camel) 케이스 형식의 별칭을 지정하면 _스네이크(snake) 케이스_로 변환됩니다. 예를 들어 MyMetricName는 Datadog에서 my_metric_name로 표시됩니다.

속성 필터

attribute 필터는 다음 두 가지 유형의 값을 허용합니다.

• 키가 속성 이름인 사전입니다(아래 참조). 이 경우 Datadog에서 메트릭의 별칭을 지정해 메트릭 이름으로 사용할 수 있습니다. 메트릭 유형을 게이지 또는 카운터로 지정할 수도 있습니다. 카운터를 선택하면 해당 메트릭의 초당 비율이 계산됩니다.

  conf:
    - include:
      attribute:
        maxThreads:
          alias: tomcat.threads.max
          metric_type: gauge
        currentThreadCount:
          alias: tomcat.threads.count
          metric_type: gauge
        bytesReceived:
          alias: tomcat.bytes_rcvd
          metric_type: counter
  

• 속성 이름 목록입니다(아래 참조). 이 경우 메트릭 유형은 게이지이고 메트릭 이름은 jmx.\[DOMAIN_NAME].\[ATTRIBUTE_NAME]입니다.

  conf:
    - include:
      domain: org.apache.cassandra.db
      attribute:
        - BloomFilterDiskSpaceUsed
        - BloomFilterFalsePositives
        - BloomFilterFalseRatio
        - Capacity
        - CompressionRatio
        - CompletedTasks
        - ExceptionCount
        - Hits
        - RecentHitRate
  

로그 수집

1. Datadog에 로그를 제출하려면 Tomcat은 log4j 로거를 사용합니다. 8.0 이전 버전의 Tomcat의 경우 log4j가 기본적으로 구성됩니다. Tomcat 8.0 이상의 경우 log4j를 사용하도록 Tomcat을 구성해야 합니다(Log4j 사용하기 참조). 해당 지침의 첫 번째 단계에서 $CATALINA_BASE/lib 디렉터리에 있는 log4j.properties 파일을 다음과 같이 편집합니다.

     log4j.rootLogger = INFO, CATALINA
   
     # Define all the appenders
     log4j.appender.CATALINA = org.apache.log4j.DailyRollingFileAppender
     log4j.appender.CATALINA.File = /var/log/tomcat/catalina.log
     log4j.appender.CATALINA.Append = true
   
     # Roll-over the log once per day
     log4j.appender.CATALINA.layout = org.apache.log4j.PatternLayout
     log4j.appender.CATALINA.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c{1}:%L - %m%n
   
     log4j.appender.LOCALHOST = org.apache.log4j.DailyRollingFileAppender
     log4j.appender.LOCALHOST.File = /var/log/tomcat/localhost.log
     log4j.appender.LOCALHOST.Append = true
     log4j.appender.LOCALHOST.layout = org.apache.log4j.PatternLayout
     log4j.appender.LOCALHOST.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c{1}:%L - %m%n
   
     log4j.appender.MANAGER = org.apache.log4j.DailyRollingFileAppender
     log4j.appender.MANAGER.File = /var/log/tomcat/manager.log
     log4j.appender.MANAGER.Append = true
     log4j.appender.MANAGER.layout = org.apache.log4j.PatternLayout
     log4j.appender.MANAGER.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c{1}:%L - %m%n
   
     log4j.appender.HOST-MANAGER = org.apache.log4j.DailyRollingFileAppender
     log4j.appender.HOST-MANAGER.File = /var/log/tomcat/host-manager.log
     log4j.appender.HOST-MANAGER.Append = true
     log4j.appender.HOST-MANAGER.layout = org.apache.log4j.PatternLayout
     log4j.appender.HOST-MANAGER.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c{1}:%L - %m%n
   
     log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
     log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
     log4j.appender.CONSOLE.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c{1}:%L - %m%n
   
     # Configure which loggers log to which appenders
     log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost] = INFO, LOCALHOST
     log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/manager] =\
       INFO, MANAGER
     log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/host-manager] =\
       INFO, HOST-MANAGER
   

   그런 다음 Tomcat 설명서의 나머지 단계에 따라 log4j를 구성합니다.

2. 기본적으로 Datadog 통합 파이프라인은 다음과 같은 전환 패턴을 지원합니다.

     %d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n
     %d [%t] %-5p %c - %m%n
   

   다른 형식이 있는 경우 통합 파이프라인을 복제하여 편집하세요. Tomcat 로깅 기능에 대한 자세한 내용은 Tomcat에서 로깅하기를 참조하세요.

3. Datadog 에이전트에서 로그 수집은 기본적으로 사용하지 않도록 설정되어 있습니다. datadog.yaml파일에서 로그 수집을 사용하도록 설정합니다.

   logs_enabled: true
   

4. 이 구성 블록을 tomcat.d/conf.yaml 파일에 추가하여 Tomcat 로그 수집을 시작하세요.

   logs:
     - type: file
       path: /var/log/tomcat/*.log
       source: tomcat
       service: "<SERVICE>"
       #To handle multi line that starts with yyyy-mm-dd use the following pattern
       #log_processing_rules:
       #  - type: multi_line
       #    name: log_start_with_date
       #    pattern: \d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])
   

   path 및 service 파라미터 값을 변경하고 사용자 환경에 맞게 구성합니다. 사용 가능한 모든 구성 옵션은 샘플 tomcat.yaml을 참조하세요.

5. 에이전트를 재시작하세요.

컨테이너화

컨테이너화된 환경의 경우 JMX를 사용한 자동탐지 가이드를 참조하세요.