넥스트클라우드 통합

Nextcloud 대시보드를 사용하면 시스템의 파일 수, 사용자 계정 및 데이터베이스 크기를 쉽게 추적할 수 있습니다. 당사의 인프라 에이전트와 Prometheus OpenMetrics 통합으로 구축된 Nextcloud 통합은 일련의 기본값을 제공합니다. 가장 중요한 데이터를 모두 한 곳에서 볼 수 있습니다.

전제 조건

New Relic에서 Nextcloud 데이터를 가져오려면 다음을 수행해야 합니다.

• Go 설치
• make 명령 설치
• Nextcloud 22 이상 사용

인프라 에이전트 설치

데이터를 New Relic으로 가져오려면 인프라 에이전트를 설치하십시오. 당사의 인프라 에이전트는 데이터를 수집하고 수집하므로 앱의 성능을 추적할 수 있습니다.

두 가지 방법으로 인프라 에이전트를 설치할 수 있습니다.

• 가이드 설치 는 시스템을 검사하고 시스템에 가장 적합한 애플리케이션 모니터링 에이전트와 함께 인프라 에이전트를 설치하는 CLI 도구입니다. 가이드 설치 작동 방식에 대해 자세히 알아보려면 가이드 설치 개요 를 확인하세요.
• 인프라 에이전트를 수동으로 설치하려면 Linux, Windows또는 macOS용 수동 설치에 대한 자습서를 따를 수 있습니다.

Nextcloud 데이터 내보내기

통합 프로세스를 시작하려면 nextcloud-exporter 를 사용하여 Nextcloud 측정항목을 내보내야 합니다. 이를 통해 Prometheus OpenMetrics 통합이 데이터를 New Relic으로 수집할 수 있습니다. 메트릭을 노출한 후에는 토큰 인증을 완료해야 합니다.

Prometheus OpenMetrics를 Nextcloud와 통합

인프라 에이전트가 설치되어 있으면 Prometheus OpenMetrics 통합을 통해 Nextcloud와 New Relic 간에 통신 회선을 설정해야 합니다. Prometheus OpenMetrics는 노출된 Nextcloud 데이터를 스크랩하여 사전 구축된 대시보드에 표시합니다.

1. 지침에 따라 Prometheus OpenMetrics 통합 을 설치합니다.

2. Prometheus OpenMetrics 통합을 설치한 폴더인 /etc/newrelic-infra/integrations.d로 이동하여 nri-prometheus.config.yml이라는 파일을 생성합니다.

3. nri-prometheus.config.yml 샘플 파일의 콘텐츠를 복사하여 nri-prometheus.config.yml 파일에 붙여넣습니다. 서버 관련 정보를 얻으려면 targets 키 내부의 URL 값을 바꾸십시오. URL은 노출된 Nextcloud 메트릭과 연결된 URL과 일치해야 합니다.

   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: "my_exporter"
   
         targets:
           - description: Secure etcd example
             urls: ["http://127.0.0.1:9205"]
         #    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 "5s" if it is not set.
         # scrape_timeout: "5s"
   
         # Length in time to distribute the scraping from the endpoints. Default to "30s" if it is not set.
         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: false
   
       timeout: 10s

   복사

4. New Relic 인프라 서비스를 다시 시작하십시오.

5. 사전 구축된 대시보드를 사용하려면 Nextcloud 빠른 시작을 설치하세요.

NRQL을 사용하여 데이터 쿼리

이 샘플 쿼리를 사용하여 one.newrelic.com에서 캡처된 Lighttpd 지표를 확인하세요.

다음은 지난 5분 동안 활성 사용자 수를 확인하는 NRQL 쿼리의 예입니다.

SELECT latest(nextcloud_active_users_total) FROM Metric

다음은 지난 24시간 동안 활성 사용자 수를 확인하는 NRQL 쿼리의 예입니다.

SELECT latest(nextcloud_active_users_daily_total) FROM Metric

다음은 뭐지?

NRQL 쿼리 작성 및 대시보드 생성에 대해 자세히 알아보려면:

• 기본 및 고급 쿼리를 생성하려면 쿼리 작성기에 대한 소개를 읽으십시오.

• 대시보드 소개를 읽고 대시보드를 사용자 정의하고 다양한 작업을 수행하십시오.

• 대시보드를 관리 하여

  디스플레이 모드를 사용하거나 대시보드에 더 많은 콘텐츠를 추가할 수 있습니다.

문제점 해결

문제

Nextcloud에서 페이지를 열 때마다 다음 오류 메시지가 표시됩니다.

$
Invalid private key for encryption app. Please update your private key password in your personal settings to recover access to your encrypted files.

해결책

1. 다음을 실행하여 Nextcloud 암호화 상태를 확인합니다.

   bash

   복사

   $
   sudo -u www-data php /var/www/html/occ encryption:status

2. enabled: false표시되면 다음을 실행하여 암호화를 활성화합니다.

   bash

   복사

   $
   sudo -u www-data php /var/www/html/occ encryption:enable

3. 다음을 실행하여 암호화가 활성화되었는지 확인합니다.

   bash

   복사

   $
   sudo -u www-data php /var/www/html/occ encryption:status

이제 Nextcloud를 종료하고 Nextcloud 브라우저 세션을 새로 고칩니다. 더 이상 오류 메시지가 표시되지 않아야 합니다.