SonarQube 모니터링 통합

인프라 에이전트 설치

SonarQube 통합을 사용하려면 먼저 동일한 호스트에 인프라 에이전트를 설치 해야 합니다. 모든 온호스트 통합에는 지표를 뉴렐릭에 노출하고 보고하는 데 도움이 되는 베어링 에이전트가 필요합니다.

PostgreSQL 통합 설치

SonarQube 통합을 사용하려면 먼저 PostgreSQL 통합을 설치해야 합니다.

1. 통합을 설치하기 전에 설명서 에서 PostgreSQL 통합 요구 사항을 확인하세요. 호환성을 확인한 후 이 문서로 돌아오세요.

2. PostgreSQL 빠른 시작 페이지 열기 PostgreSQL 빠른 시작 설치.

3. PostgreSQL 퀵스타트 설치를 시작하려면

   Install now

   클릭하세요.

NRI-Prometheus 구성

1. 다음 명령을 실행하여 NRI-Prometheus 구성 파일을 생성합니다.

   bash

   카피

   $
   touch /etc/newrelic-infra/integrations.d/nri-prometheus-config.yml

2. 새 구성 파일에 다음 스니펫을 붙여넣으세요. 관련 필드로 cluster_name 및 urls 를 업데이트해야 합니다.

   integrations:
     - name: nri-prometheus
       config:
         # When standalone is set to false nri-prometheus requires an infrastructure agent to work and send data. Defaults to true 
         standalone: false
   
         # When running with infrastructure agent emitters will have to include infra-sdk 
         emitters: infra-sdk
   
         # The name of your cluster. It's important to match other New Relic products to relate the data.
         cluster_name: "YOUR_CLUSTER_NAME"
   
         targets:
           - description: Sonarqube metrics list
             urls: ["http://user_name:password@YOUR_HOST_IP:9000/api/monitoring/metrics"]
   
         #     tls_config:
         #     ca_file_path: "/etc/etcd/etcd-client-ca.crt"
         #     cert_file_path: "/etc/etcd/etcd-client.crt"
         #      key_file_path: "/etc/etcd/etcd-client.key"
   
         # Whether the integration should run in verbose mode or not. Defaults to false
         verbose: false
   
         # Whether the integration should run in audit mode or not. Defaults to false.
         # Audit mode logs the uncompressed data sent to New Relic. Use this to log all data sent.
         # It does not include verbose mode. This can lead to a high log volume, use with care
         audit: false
   
         # The HTTP client timeout when fetching data from endpoints. Defaults to 30s.
         # scrape_timeout: "30s"
   
         # Length in time to distribute the scraping from the endpoints
         scrape_duration: "5s"
   
         # Number of worker threads used for scraping targets.
         # For large clusters with many (>400) endpoints, slowly increase until scrape
         # time falls between the desired `scrape_duration`.
         # Increasing this value too much will result in huge memory consumption if too
         # many metrics are being scraped.
         # Default: 4
         # worker_threads: 4
   
         # Whether the integration should skip TLS verification or not. Defaults to false
         insecure_skip_verify: true
       timeout: 10s

   카피

JMX 통합 설치 및 구성

SonarQube 통합을 사용하려면 JMX 모니터링 통합도 설치 해야 합니다. JMX 통합은 SonarQube 데이터를 스크랩하며, 나중에 이를 대시보드 및 쿼리 가능한 데이터로 전환합니다.

1. JMX 모니터링 통합을 설치합니다.

2. 다음 코드 스니펫을 /opt/sonarqube/conf/sonar.properties 에 추가하세요.

   # SonarQube Web Server JMX configuration.
     sonar.web.javaOpts=-Dcom.sun.management.jmxremote \
                     -Dcom.sun.management.jmxremote.port=9010 \
                     -Dcom.sun.management.jmxremote.authenticate=false \
                     -Dcom.sun.management.jmxremote.ssl=false
   
   # SonarQube Compute Engine JMX configuration.
     sonar.ce.javaOpts=-Dcom.sun.management.jmxremote \
                     -Dcom.sun.management.jmxremote.port=9011 \
                     -Dcom.sun.management.jmxremote.authenticate=false \
                     -Dcom.sun.management.jmxremote.ssl=false

   카피

3. 다음 코드 스니펫을 /etc/newrelic-infra/integrations.d/jvm-sonarqube-web-metrics.yml/ 에 추가하세요.

   collect:
     - domain: SonarQube
       event_type: JVMSampleSonarQubeWebMetrics
       beans:
         - query: name=AsyncExecution
           attributes:
             - QueueSize
             - WorkerCount
             - LargestWorkerCount
         - query: name=Database
           attributes:
             - MigrationStatus
             - PoolActiveConnections
             - PoolMaxActiveConnections
             - PoolIdleConnections
             - PoolMaxIdleConnections
             - PoolMinIdleConnections
             - PoolInitialSize
             - PoolMaxWaitMillis
             - PoolRemoveAbandoned
             - PoolRemoveAbandonedTimeoutSeconds
         - query: name=SonarQube
           attributes:
             - Version
             - ServerId
             - LogLevel

   카피

4. 다음 코드 스니펫을 /etc/newrelic-infra/integrations.d/jvm-sonarqube-compute-engine-metrics.yml 에 추가하세요.

   collect:
     - domain: SonarQube
       event_type: JVMSampleSonarQubeComputeEngineMetrics
       beans:
         - query: name=ComputeEngineDatabaseConnection
           attributes:
             - PoolInitialSize
             - PoolActiveConnections
             - PoolMaxActiveConnections
             - PoolIdleConnections
             - PoolMaxIdleConnections
             - PoolMinIdleConnections
             - PoolMaxWaitMillis
             - PoolRemoveAbandoned
             - PoolRemoveAbandonedTimeoutSeconds
         - query: name=ComputeEngineTasks
           attributes:
             - PendingCount
             - LongestTimePending
             - InProgressCount
             - ErrorCount
             - SuccessCount
             - ProcessingTime
             - WorkerMaxCount
             - WorkerCount
             - WorkerUuids
             - EnabledWorkerUuids

   카피

5. 다음 코드 스니펫을 /etc/newrelic-infra/integrations.d/jmx-sonarqube-compute-engine-config.yml 에 추가하세요.

   integrations:
     - name: nri-jmx
       env:
         COLLECTION_FILES: /etc/newrelic-infra/integrations.d/jvm-sonarqube-compute-engine-metrics.yml
         JMX_HOST: <YOUR_HOST>
         JMX_PASS: admin
         JMX_PORT: 9010
         JMX_USER: admin
         CONNECTION_URL: service:jmx:rmi://<YOUR_IP>:9010/jndi/rmi://<YOUR_IP>:9010/jmxrmi
         REMOTE_MONITORING: "true"
       interval: 15s
       labels:
         env: staging

   카피

6. 다음 코드 스니펫을 /etc/newrelic-infra/integrations.d/jmx-sonarqube-web-config.yml 에 추가하세요.

   integrations:
     - name: nri-jmx
       env:
         COLLECTION_FILES: /etc/newrelic-infra/integrations.d/jvm-sonarqube-web-metrics.yml
         JMX_HOST: <YOUR_HOST>
         JMX_PASS: admin
         JMX_PORT: 9011
         JMX_USER: admin
         CONNECTION_URL: service:jmx:rmi://<YOUR_IP>:9011/jndi/rmi://<YOUR_IP>:9011/jmxrmi
         REMOTE_MONITORING: "true"
       interval: 15s
       labels:
         env: staging

   카피

New Relic에 SonarQube 로그 전달

SonarQube 로그를 뉴렐릭으로 전달하려면 다음 단계를 따르세요.

1. 다음 경로에 logging.yml 이라는 로그 파일을 생성합니다.

   bash

   카피

   $
   cd /etc/newrelic-infra/logging.d

2. logging.yml 파일에 다음 스크립트를 추가합니다.

   logs:
     - name: sonar_logs
       file: /opt/sonarqube/logs/sonar.log
       attributes: 
         logtype: sonar_logs
     - name: ce_logs
       file: /opt/sonarqube/logs/ce.log
       attributes:
         logtype: sonar_ce_logs
     - name: es_logs
       file: /opt/sonarqube/logs/es.log
       attributes: 
         logtype: sonar_es_logs
     - name: web_logs
       file: /opt/sonarqube/logs/web.log
       attributes:
         logtype: sonar_web_logs

   카피

New Relic 인프라 에이전트 다시 시작

인프라 에이전트를 다시 시작합니다.

$
sudo systemctl restart newrelic-infra.service

몇 분 안에 애플리케이션이 메트릭을 one.newrelic.com 으로 보냅니다.

데이터 찾기

SonarQube 애플리케이션 메트릭을 모니터링하기 위해 SonarQube 이라는 사전 빌드된 대시보드 템플릿을 선택할 수 있습니다. 사전 구축된 대시보드 템플릿을 사용하려면 다음 단계를 따르세요.

1. one.newrelic.com 에서,

   + Integrations & Agents

   페이지로 이동하세요.

2. Dashboards

   을 클릭합니다.

3. 검색창에 sonarqube 를 입력합니다.

4. SonarQube 대시보드가 나타납니다. 그것을 클릭하여 설치하십시오.

   귀하의 SonarQube 대시보드는 맞춤형 대시보드로 간주되며 Dashboards UI 에서 찾을 수 있습니다. 대시보드 사용 및 편집에 대한 문서는 대시보드 문서 를 참조하세요.

   다음은 Postfix 데이터에 대한 몇 가지 NRQL 쿼리 예입니다.

   SonarQube 웹 상태를 확인하세요

   SELECT latest(sonarqube_web_uptime_minutes) 
   AS 'SonarQube Web Uptime (minutes)' 
   FROM Metric

   카피

   JVM 지표 보기

   SELECT latest(PoolIdleConnections) FROM JVMSampleSonarQubeWebMetrics

   카피