Elasticsearch 모니터링 통합

Elasticsearch 통합은 Elasticsearch 클러스터에서 인벤토리와 지표를 수집하여 Elasticsearch 환경의 상태를 볼 수 있는 플랫폼으로 보냅니다. 클러스터, 노드 및 인덱스 수준에서 메트릭을 수집하므로 문제의 원인을 더 쉽게 찾을 수 있습니다.

Elasticsearch 모니터링 통합을 설치하려면 다음 단계를 실행하십시오.

통합을 설치하고 활성화합니다 .
통합을 구성합니다 .
데이터를 찾아 사용합니다 .
선택적으로 Elasticsearch의 구성 설정 을 참조하십시오.

호환성 및 요구 사항

Elasticsearch 버전

우리의 통합은 Elasticsearch 7.x에서 8.X까지 호환됩니다.

지원되는 운영 체제

윈도우
리눅스

특정 Windows 및 Linux 버전의 전체 목록은 호환되는 운영 체제 표를 확인하세요.

시스템 요구 사항

New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
Elasticsearch가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않다면 Elasticsearch를 실행하는 호스트에 인프라 에이전트를 설치하십시오 . 그렇지 않으면:
- 실행 중인 경우
  Kubernetes, 이러한 요구 사항 참조.
- 실행 중인 경우
  Amazon ECS, 이러한 요구 사항 참조.

통합 설치 및 활성화

Elasticsearch 통합을 설치하려면 환경에 대한 지침을 따르십시오.

리눅스 설치

통합 설치 지침을 따르고 INTEGRATION_FILE_NAME 변수를 nri-elasticsearch 로 바꿉니다.
다음을 실행하여 디렉토리를 통합 구성 폴더로 변경하십시오.
bash
```
$cd /etc/newrelic-infra/integrations.d
```
다음을 실행하여 샘플 구성 파일을 복사합니다.
bash
```
$sudo cp elasticsearch-config.yml.sample elasticsearch-config.yml
```
선호하는 편집기로 elasticsearch-config.yml 구성 파일을 편집합니다. 일부 구성 파일 예제를 확인하십시오.
자동 Elasticsearch 오류 로그 구문 분석 및 전달을 활성화하려면 elasticsearch-log.yml.example 파일을 elasticsearch-log.yml 에 복사(또는 이름 변경)하십시오. 에이전트를 다시 시작할 필요가 없습니다.

예시

bash

$sudo cp /etc/newrelic-infra/logging.d/elasticsearch-log.yml.example /etc/newrelic-infra/logging.d/elasticsearch-log.yml

기타 환경

다음에서 nri-elasticsearch .MSI 설치 프로그램 이미지를 다운로드합니다.
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-elasticsearch/nri-elasticsearch-amd64.msi
Windows 명령 프롬프트에서 설치하려면 다음을 실행하십시오.
```
msiexec.exe /qn /i PATH\TO\nri-elasticsearch-amd64.msi
```
통합 디렉토리 C:\Program Files\New Relic\newrelic-infra\integrations.d\ 에서 다음을 실행하여 샘플 구성 파일의 복사본을 만듭니다.
```
cp elasticsearch-config.yml.sample elasticsearch-config.yml
```
Elasticsearch-config.yml 샘플 파일 에 설명된 대로 elasticsearch-config.yml 파일을 편집합니다.

추가 참고 사항:

고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.

이 문서가 설치하는데 도움이 되셨나요?

통합 구성

설치 방법에 따라 통합을 구성하는 몇 가지 방법이 있습니다.

다음을 통해 활성화된 경우
Kubernetes, Kubernetes에서 실행 중인 모니터링 서비스 참조.
다음을 통해 활성화된 경우
Amazon ECS, ECS에서 실행되는 모니터링 서비스 참조 .
호스트에 설치된 경우 통합의 YAML 구성 파일 elasticsearch-config.yml 에서 구성을 편집합니다. 통합의 YAML 형식 구성은 필수 로그인 자격 증명을 배치하고 데이터 수집 방법을 구성할 수 있는 곳입니다. 변경하는 옵션은 설정 및 기본 설정에 따라 다릅니다. 구성 파일에는 interval , timeout , inventory_source 와 같은 모든 통합에 적용할 수 있는 공통 설정이 있습니다. 이러한 공통 설정에 대한 모든 내용을 읽으려면 구성 형식 문서를 참조하십시오.

중요

레거시 구성 또는 정의 파일을 계속 사용하는 경우 표준 구성 형식 을 확인하십시오.

Elasticsearch-config.yml 샘플 파일

다음은 localhost에서 메트릭 및 인벤토리를 수집하는 데 사용되는 기본 구성입니다.

integrations:
  - name: nri-elasticsearch
    env:
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 15s
    labels:
      environment: production
    inventory_source: config/elasticsearch

이 구성은 15초마다 메트릭을 수집하고 60초마다 인벤토리를 수집합니다.

integrations:
  - name: nri-elasticsearch
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-elasticsearch
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 60s
    labels:
      environment: production
    inventory_source: config/elasticsearch

이 구성에서는 환경 변수 ELASTIC_HOST 를 사용하여 통합의 HOSTNAME 설정을 채웁니다.

integrations:
  - name: nri-elasticsearch
    env:
      METRICS: "true"
      HOSTNAME: {{ELASTIC_HOST}}
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

통합은 모든 클러스터 메트릭을 스크랩하기 전에 표시되는 기본 구성을 사용하여 노드 중 하나에 연결된 클러스터에서 모든 메트릭을 수집할 수 있습니다.

통합을 구성하는 또 다른 방법은 모든 인스턴스의 스크랩을 구성하되 스크랩된 인스턴스가 마스터인 경우에만 통합이 측정항목을 수집하도록 하는 MASTER_ONLY 매개변수를 활성화하는 것입니다. 이를 통해 모든 노드에 대해 동일한 구성을 공유하고 데이터 중복을 피할 수 있습니다.
각 노드의 구성 파일은 다음과 같아야 합니다.

integrations:
  - name: nri-elasticsearch
    env:
      HOSTNAME: localhost
      PORT: 9200
      USERNAME: elasticsearch_user
      PASSWORD: elasticsearch_password
      MASTER_ONLY: "true"
      CONFIG_PATH: /etc/elasticsearch/elasticsearch.yml
    interval: 15s
    labels:
      environment: production
    inventory_source: config/elasticsearch

통합을 위한 구성 옵션

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 Elasticsearch의 구성 설정 을 참조하십시오.

데이터 찾기 및 사용

이 서비스의 데이터는 통합 대시보드 에 보고됩니다.

Elasticsearch 데이터는 다음 이벤트 유형 에 연결됩니다.

ElasticsearchClusterSample
ElasticsearchNodeSample
ElasticsearchCommonSample
ElasticsearchIndexSample

문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.

데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터를 이해 하는 방법을 참조하세요.

통합으로 수집된 측정항목

Elasticsearch 통합은 다음 지표를 수집합니다. 각 측정항목 이름에는 cluster. 또는 shards. 과 같은 카테고리 표시기와 마침표가 접두사로 붙습니다.

미터법	설명
`cluster.dataNodes`	클러스터의 데이터 노드 수입니다.
`cluster.nodes`	클러스터의 노드 수입니다.
`cluster.status`	Elasticsearch 클러스터 상태: `red` , `yellow` 또는 `green` .
`shards.active`	클러스터의 활성 샤드 수입니다.
`shards.initializing`	현재 초기화 중인 샤드의 수입니다.
`shards.primaryActive`	클러스터의 활성 기본 샤드 수입니다.
`shards.relocating`	한 노드에서 다른 노드로 재배치되는 샤드의 수입니다.
`shards.unassigned`	노드에 할당되지 않은 샤드의 수입니다.

미터법	설명
`activeSearches`	활성 검색 수입니다.
`activeSearchesInMilliseconds`	검색 가져오기에 소요된 시간입니다.
`breakers.estimatedSizeFieldDataCircuitBreakerInBytes`	필드 데이터 회로 차단기의 예상 크기(바이트)입니다.
`breakers.estimatedSizeParentCircuitBreakerInBytes`	상위 회로 차단기의 예상 크기(바이트)입니다.
`breakers.estimatedSizeRequestCircuitBreakerInBytes`	요청 회로 차단기의 예상 크기(바이트)입니다.
`breakers.fieldDataCircuitBreakerTripped`	필드 데이터 회로 차단기가 트립된 횟수입니다.
`breakers.parentCircuitBreakerTripped`	상위 회로 차단기가 트립된 횟수입니다.
`breakers.requestCircuitBreakerTripped`	요청 회로 차단기가 트립된 횟수입니다.
`cache.cacheSizeIDInBytes`	ID 캐시의 크기(바이트)입니다.
`flush.indexFlushDisk`	시작 이후 디스크에 대한 인덱스 플러시 횟수입니다.
`flush.timeFlushIndexDiskInSeconds`	인덱스를 디스크로 플러시하는 데 소요된 시간입니다.
`fs.bytesAvailableJVMInBytes`	이 파일 저장소에서 이 JVM(Java Virtual Machine)에 사용할 수 있는 바이트(바이트)입니다.
`fs.bytesReadsInBytes`	파일 저장소에서 읽은 총 바이트(바이트)입니다.
`fs.bytesUserIoOperationsInBytes`	파일 저장소의 모든 I/O 작업에 사용된 총 바이트(바이트)입니다.
`fs.iOOperations`	파일 저장소의 총 I/O 작업입니다.
`fs.reads`	파일 저장소의 총 읽기 수입니다.
`fs.totalSizeInBytes`	파일 저장소의 총 크기(바이트)입니다.
`fs.unallocatedBytesInBytes`	파일 저장소에서 할당되지 않은 총 바이트 수(바이트)입니다.
`fs.writes`	파일 저장소에 대한 총 쓰기 수입니다.
`fs.writesInBytes`	파일 저장소에 기록된 총 바이트(바이트)입니다.
`get.currentRequestsRunning`	현재 실행 중인 가져오기 요청 수입니다.
`get.requestsDocumentExists`	문서가 존재하는 get 요청의 수입니다.
`get.requestsDocumentExistsInMilliseconds`	문서가 존재하는 get 요청에 소요된 시간입니다.
`get.requestsDocumentMissing`	문서가 누락된 가져오기 요청 수입니다.
`get.requestsDocumentMissingInMilliseconds`	문서가 누락된 요청 가져오기에 소요된 시간입니다.
`get.timeGetRequestsInMilliseconds`	요청 가져오기에 소요된 시간입니다.
`get.totalGetRequests`	가져오기 요청 수입니다.
`http.currentOpenConnections`	현재 열려 있는 HTTP 연결 수입니다.
`http.openedConnections`	열린 HTTP 연결 수입니다.
`indexing.docsCurrentlyDeleted`	인덱스에서 현재 삭제 중인 문서의 수입니다.
`indexing.documentsCurrentlyIndexing`	현재 인덱스에 인덱싱되는 문서의 수입니다.
`indexing.documentsIndexed`	인덱스에 인덱싱된 문서의 수입니다.
`indexing.timeDeletingDocumentsInMilliseconds`	색인에서 문서를 삭제하는 데 소요된 시간입니다.
`indexing.timeIndexingDocumentsInMilliseconds`	문서를 색인에 색인하는 데 소요된 시간입니다.
`indexing.totalDocumentsDeleted`	인덱스에서 삭제된 문서 수입니다.
`indices.indexingOperationsFailed`	실패한 인덱싱 작업의 수입니다.
`indices.indexingWaitedThrottlingInMilliseconds`	조절로 인해 인덱싱이 대기한 시간입니다.
`indices.memoryQueryCacheInBytes`	쿼리 캐시에서 사용하는 메모리(바이트)입니다.
`indices.numberIndices`	노드에 할당된 모든 기본 샤드의 문서 수입니다.
`indices.queryCacheEvictions`	쿼리 캐시 제거 수입니다.
`indices.queryCacheHits`	쿼리 캐시 적중 횟수입니다.
`indices.queryCacheMisses`	쿼리 캐시 누락 수입니다.
`indices.recoveryOngoingShardSource`	샤드가 소스 역할을 하는 진행 중인 복구 수입니다.
`indices.recoveryOngoingShardTarget`	샤드가 대상으로 사용되는 진행 중인 복구 수입니다.
`indices.recoveryWaitedThrottlingInMilliseconds`	조절로 인해 복구가 대기한 총 시간입니다.
`indices.requestCacheEvictions`	요청 캐시 제거 수입니다.
`indices.requestCacheHits`	요청 캐시 적중 횟수입니다.
`indices.requestCacheMemoryInBytes`	요청 캐시에서 사용하는 메모리(바이트)입니다.
`indices.requestCacheMisses`	요청 캐시 누락 수입니다.
`indices.segmentsIndexShard`	인덱스 샤드의 세그먼트 수입니다.
`indices.segmentsMaxMemoryIndexWriterInBytes`	인덱스 작성기가 사용하는 최대 메모리(바이트)입니다.
`indices.segmentsMemoryUsedDocValuesInBytes`	문서 값이 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedFixedBitSetInBytes`	고정 비트 세트에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedIndexSegmentsInBytes`	인덱스 세그먼트에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedIndexWriterInBytes`	인덱스 작성기가 사용한 메모리(바이트)입니다.
`indices.segmentsMemoryUsedNormsInBytes`	표준에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedSegmentVersionMapInBytes`	세그먼트 버전 맵에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedStoredFieldsInBytes`	저장된 필드에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedTermsInBytes`	용어에서 사용하는 메모리(바이트)입니다.
`indices.segmentsMemoryUsedTermVectorsInBytes`	용어 벡터에서 사용하는 메모리(바이트)입니다.
`indices.translogOperations`	트랜잭션 로그의 작업 수입니다.
`indices.translogOperationsInBytes`	트랜잭션 로그의 크기(바이트)입니다.
`jvm.gc.collections`	JVM에서 실행하는 가비지 컬렉션의 수입니다.
`jvm.gc.collectionsInMilliseconds`	JVM에서 가비지 수집에 소요된 시간입니다.
`jvm.gc.concurrentMarkSweep`	JVM의 동시 표시 및 스윕 GC 수입니다.
`jvm.gc.concurrentMarkSweepInMilliseconds`	JVM에서 동시 표시 및 스윕 GC에 소요된 시간입니다.
`jvm.gc.majorCollectionsOldGenerationObjects`	이전 세대 개체를 수집하는 JVM의 주요 GC 수입니다.
`jvm.gc.majorCollectionsOldGenerationObjectsInMilliseconds`	이전 세대 개체를 수집하는 JVM의 주요 GC에서 보낸 시간입니다.
`jvm.gc.minorCollectionsYoungGenerationObjects`	젊은 세대 개체를 수집하는 JVM의 마이너 GC 수입니다.
`jvm.gc.minorCollectionsYoungGenerationObjectsInMilliseconds`	Young Generation 객체를 수집하는 JVM에서 마이너 GC에 소요된 시간입니다.
`jvm.gc.parallelNewCollections`	JVM의 병렬 새 GC 수입니다.
`jvm.gc.parallelNewCollectionsInMilliseconds`	JVM에서 병렬 새 GC에 소요된 시간입니다.
`jvm.mem.heapCommittedInBytes`	JVM 힙에서 사용할 수 있도록 보장된 메모리 양(바이트)입니다.
`jvm.mem.heapMaxInBytes`	JVM 힙에서 사용할 수 있는 최대 메모리 양(바이트)입니다.
`jvm.mem.heapUsed`	현재 JVM 힙에서 사용하는 메모리의 백분율( `0` 과 `1` 사이의 값)
`jvm.mem.heapUsedInBytes`	현재 JVM 힙에서 사용하는 메모리 양(바이트)입니다.
`jvm.mem.maxOldGenerationHeapInBytes`	이전 세대 힙에서 사용할 수 있는 최대 메모리 양(바이트)입니다.
`jvm.mem.maxSurvivorSpaceInBytes`	생존 공간에서 사용할 수 있는 최대 메모리 양(바이트)입니다.
`jvm.mem.maxYoungGenerationHeapInBytes`	젊은 세대 힙에서 사용할 수 있는 최대 메모리 양(바이트)입니다.
`jvm.mem.nonHeapCommittedInBytes`	힙이 아닌 JVM에서 사용할 수 있도록 보장된 메모리 양(바이트)입니다.
`jvm.mem.nonHeapUsedInBytes`	힙이 아닌 JVM에서 현재 사용하는 메모리 양(바이트)입니다.
`jvm.mem.usedOldGenerationHeapInBytes`	이전 세대 힙에서 현재 사용 중인 메모리 양(바이트)입니다.
`jvm.mem.usedSurvivorSpaceInBytes`	현재 생존 공간에서 사용하는 메모리 양(바이트)입니다.
`jvm.mem.usedYoungGenerationHeapInBytes`	현재 젊은 세대 힙에서 사용하는 메모리 양(바이트)입니다.
`jvm.ThreadsActive`	JVM의 활성 스레드 수입니다.
`jvm.ThreadsPeak`	JVM에서 사용하는 최대 스레드 수입니다.
`merges.currentActive`	현재 활성 세그먼트 병합 수입니다.
`merges.docsSegmentsMerging`	현재 병합 중인 세그먼트의 문서 수입니다.
`merges.docsSegmentMerges`	병합된 모든 세그먼트의 문서 수입니다.
`merges.mergedSegmentsInBytes`	병합된 모든 세그먼트의 크기(바이트)입니다.
`merges.segmentMerges`	세그먼트 병합 수입니다.
`merges.sizeSegmentsMergingInBytes`	현재 병합 중인 세그먼트의 크기(바이트)입니다.
`merges.totalSegmentMergingInMilliseconds`	세그먼트 병합에 소요된 시간입니다.
`openFD`	현재 프로세스와 연결된 열린 파일 설명자의 수이거나 지원되지 않는 경우 `-1` 입니다.
`queriesTotal`	쿼리 수입니다.
`refresh.total`	인덱스 새로 고침 횟수입니다.
`refresh.totalInMilliseconds`	인덱스 새로 고침에 소요된 시간입니다.
`searchFetchCurrentlyRunning`	현재 실행 중인 검색 가져오기 수입니다.
`searchFetches`	검색 가져오기 수입니다.
`sizeStoreInBytes`	저장소 크기(바이트)입니다.
`threadpool.bulk.Queue`	벌크 풀의 대기열에 있는 스레드 수입니다.
`threadpool.bulkActive`	벌크 풀의 활성 스레드 수입니다.
`threadpool.bulkRejected`	대량 풀에서 거부된 스레드 수입니다.
`threadpool.bulkThreads`	벌크 풀의 스레드 수입니다.
`threadpool.fetchShardStartedQueue`	페치 샤드 시작 풀의 대기 중인 스레드 수입니다.
`threadpool.fetchShardStartedRejected`	페치 샤드 시작 풀에서 거부된 스레드 수입니다.
`threadpool.fetchShardStartedThreads`	페치 샤드 시작 풀의 스레드 수입니다.
`threadpool.fetchShardStoreActive`	가져오기 샤드 저장소 풀의 활성 스레드 수입니다.
`threadpool.fetchShardStoreQueue`	가져오기 샤드 저장소 풀의 대기 중인 스레드 수입니다.
`threadpool.fetchShardStoreRejected`	가져오기 샤드 저장소 풀에서 거부된 스레드 수입니다.
`threadpool.fetchShardStoreThreads`	가져오기 샤드 저장소 풀의 스레드 수입니다.
`threadpool.flushActive`	플러시 대기열의 활성 스레드 수입니다.
`threadpool.flushQueue`	플러시 풀의 대기열에 있는 스레드 수입니다.
`threadpool.flushRejected`	플러시 풀에서 거부된 스레드 수입니다.
`threadpool.flushThreads`	플러시 풀의 스레드 수입니다.
`threadpool.forceMergeActive`	강제 병합 작업에 대한 활성 스레드 수입니다.
`threadpool.forceMergeQueue`	강제 병합 작업을 위해 대기 중인 스레드 수입니다.
`threadpool.forceMergeRejected`	강제 병합 작업에 대해 거부된 스레드 수입니다.
`threadpool.forceMergeThreads`	강제 병합 작업의 스레드 수입니다.
`threadpool.genericActive`	일반 풀의 활성 스레드 수입니다.
`threadpool.genericQueue`	일반 풀의 대기열에 있는 스레드 수입니다.
`threadpool.genericRejected`	일반 풀에서 거부된 스레드 수입니다.
`threadpool.genericThreads`	일반 풀의 스레드 수입니다.
`threadpool.getActive`	가져오기 풀의 활성 스레드 수입니다.
`threadpool.getQueue`	가져오기 풀의 대기 중인 스레드 수입니다.
`threadpool.getRejected`	가져오기 풀에서 거부된 스레드 수입니다.
`threadpool.getThreads`	가져오기 풀의 스레드 수입니다.
`threadpool.listenerActive`	수신기 풀의 활성 스레드 수입니다. (Elasticsearch 8에서 더 이상 사용되지 않음)
`threadpool.listenerQueue`	리스너 풀에서 대기열에 있는 스레드 수입니다. (Elasticsearch 8에서 더 이상 사용되지 않음)
`threadpool.listenerRejected`	수신기 풀에서 거부된 스레드 수입니다. (Elasticsearch 8에서 더 이상 사용되지 않음)
`threadpool.listenerThreads`	수신기 풀의 스레드 수입니다. (Elasticsearch 8에서 더 이상 사용되지 않음)
`threadpool.managementActive`	관리 풀의 활성 스레드 수입니다.
`threadpool.managementQueue`	관리 풀의 대기열에 있는 스레드 수입니다.
`threadpool.managementRejected`	관리 풀에서 거부된 스레드 수입니다.
`threadpool.managementThreads`	관리 풀의 스레드 수입니다.
`threadpool.mergeActive`	병합 풀의 활성 스레드 수입니다.
`threadpool.mergeQueue`	병합 풀의 대기 중인 스레드 수입니다.
`threadpool.mergeRejected`	병합 풀에서 거부된 스레드 수입니다.
`threadpool.mergeThreads`	병합 풀의 스레드 수입니다.
`threadpool.percolateActive`	여과 풀의 활성 스레드 수입니다.
`threadpool.percolateQueue`	여과 풀의 대기 중인 스레드 수입니다.
`threadpool.percolateRejected`	여과 풀에서 거부된 스레드 수입니다.
`threadpool.percolateThreads`	여과 풀의 스레드 수입니다.
`threadpool.refreshActive`	새로 고침 풀의 활성 스레드 수입니다.
`threadpool.refreshQueue`	새로 고침 풀의 대기 중인 스레드 수입니다.
`threadpool.refreshRejected`	새로 고침 풀에서 거부된 스레드 수입니다.
`threadpool.refreshThreads`	새로 고침 풀의 스레드 수입니다.
`threadpool.searchActive`	검색 풀의 활성 스레드 수입니다.
`threadpool.searchQueue`	검색 풀의 대기 중인 스레드 수입니다.
`threadpool.searchRejected`	검색 풀에서 거부된 스레드 수입니다.
`threadpool.searchThreads`	검색 풀의 스레드 수입니다.
`threadpool.snapshotActive`	스냅샷 풀의 활성 스레드 수입니다.
`threadpool.snapshotQueue`	스냅샷 풀의 대기 중인 스레드 수입니다.
`threadpool.snapshotRejected`	스냅샷 풀에서 거부된 스레드 수입니다.
`threadpool.snapshotThreads`	스냅샷 풀의 스레드 수입니다.
`threadpool.activeFetchShardStarted`	페치 샤드 시작 풀의 활성 스레드 수입니다.
`transport.connectionsOpened`	클러스터 통신을 위해 열린 연결 수입니다.
`transport.packetsReceived`	클러스터 통신에서 수신된 패킷 수입니다.
`transport.packetsReceivedInBytes`	클러스터 통신에서 수신된 데이터의 크기(바이트)입니다.
`transport.packetsSent`	클러스터 통신에서 보낸 패킷 수입니다.
`transport.packetsSentInBytes`	클러스터 통신에서 전송된 데이터의 크기(바이트)입니다.

미터법	설명
`primaries.docsDeleted`	기본 샤드에서 삭제된 문서 수입니다.
`primaries.docsnumber`	기본 샤드의 문서 수입니다.
`primaries.flushesTotal`	시작 이후 기본 샤드에서 디스크로의 인덱스 플러시 횟수입니다.
`primaries.flushTotalTimeInMilliseconds`	기본 샤드에서 디스크로 인덱스를 플러시하는 데 소요된 시간입니다.
`primaries.get.documentsExist`	문서가 존재하는 기본 샤드에 대한 가져오기 요청 수입니다.
`primaries.get.documentsExistInMilliseconds`	문서가 존재하는 기본 샤드에서 요청을 가져오는 데 소요된 시간입니다.
`primaries.get.documentsMissing`	문서가 누락된 기본 샤드의 가져오기 요청 수입니다.
`primaries.get.documentsMissingInMilliseconds`	문서가 누락된 기본 샤드에서 요청을 가져오는 데 소요된 시간입니다.
`primaries.get.requests`	기본 샤드의 가져오기 요청 수입니다.
`primaries.get.requestsCurrent`	현재 기본 샤드에서 실행 중인 가져오기 요청 수입니다.
`primaries.get.requestsInMilliseconds`	기본 샤드에서 요청을 가져오는 데 소요된 시간입니다.
`primaries.index.docsCurrentlyDeleted`	기본 샤드의 인덱스에서 현재 삭제 중인 문서 수입니다.
`primaries.index.docsCurrentlyDeletedInMilliseconds`	기본 샤드의 인덱스에서 문서를 삭제하는 데 소요된 시간입니다.
`primaries.index.docsCurrentlyIndexing`	현재 기본 샤드의 인덱스에 인덱싱되는 문서 수입니다.
`primaries.index.docsCurrentlyIndexingInMilliseconds`	기본 샤드의 인덱스에 문서를 인덱싱하는 데 소요된 시간입니다.
`primaries.index.docsDeleted`	기본 샤드의 인덱스에서 삭제된 문서 수입니다.
`primaries.index.docsTotal`	기본 샤드의 인덱스로 인덱싱된 문서 수입니다.
`primaries.indexRefreshesTotal`	기본 샤드의 인덱스 새로 고침 횟수입니다.
`primaries.indexRefreshesTotalInMilliseconds`	기본 샤드에서 인덱스 새로 고침에 소요된 시간입니다.
`primaries.merges.current`	기본 샤드에서 현재 활성화된 세그먼트 병합 수입니다.
`primaries.merges.docsSegmentsCurrentlyMerged`	현재 기본 샤드에서 병합되고 있는 세그먼트 전체의 문서 수입니다.
`primaries.merges.docsTotal`	기본 샤드에서 병합된 모든 세그먼트의 문서 수입니다.
`primaries.merges.SegmentsCurrentlyMergedInBytes`	현재 기본 샤드에서 병합되는 세그먼트의 크기(바이트)입니다.
`primaries.merges.SegmentsTotal`	기본 샤드의 세그먼트 병합 수입니다.
`primaries.merges.segmentsTotalInBytes`	기본 샤드에서 병합된 모든 세그먼트의 크기(바이트)입니다.
`primaries.merges.segmentsTotalInMilliseconds`	기본 샤드에서 세그먼트 병합에 소요된 시간입니다.
`primaries.queriesInMilliseconds`	기본 샤드에서 쿼리하는 데 소요된 시간입니다.
`primaries.queriesTotal`	기본 샤드에 대한 쿼리 수입니다.
`primaries.queryActive`	기본 샤드에 대한 현재 활성 쿼리 수입니다.
`primaries.queryFetches`	기본 샤드에서 현재 실행 중인 쿼리 가져오기 수입니다.
`primaries.queryFetchesInMilliseconds`	기본 샤드에서 쿼리 가져오기에 소요된 시간입니다.
`primaries.queryFetchesTotal`	기본 샤드에서 가져온 쿼리 수입니다.
`primaries.sizeInBytes`	모든 기본 샤드의 크기(바이트)입니다.

미터법	설명
`index.docs`	인덱스의 문서 수입니다.
`index.docsDeleted`	인덱스에서 삭제된 문서의 수입니다.
`index.health`	색인 상태: `red` , `yellow` 또는 `green` .
`index.primaryShards`	인덱스의 기본 샤드 수입니다.
`index.primaryStoreSizeInBytes`	인덱스에 있는 기본 샤드의 저장소 크기입니다.
`index.replicaShards`	인덱스의 복제본 샤드 수입니다.
`index.storeSizeInBytes`	인덱스에 있는 기본 및 복제본 샤드의 저장소 크기(바이트)입니다.

Elasticsearch 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.

Elasticsearch 인스턴스 설정

elasticsearch-config.yml 파일의 env 섹션을 사용하여 Elasticsearch와 관련된 특정 설정을 정의할 수 있습니다. 이러한 설정은 Elasticsearch 인스턴스에 대한 연결과 기타 보안 설정 및 기능을 제어합니다.

Elasticsearch 통합은 지표와 인벤토리 정보를 모두 수집합니다. 표에서 각 컬렉션에 사용할 수 있는 설정에 대해 적용 대상 열을 사용합니다.

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

환경	설명	기본값	에 적용
호스트 이름	Elasticsearch가 실행 중인 호스트 이름 또는 IP입니다.	로컬 호스트	미
LOCAL_HOSTNAME	인벤토리 데이터를 수집할 Elasticsearch 노드의 호스트 이름 또는 IP입니다. localhost에 대한 인벤토리 데이터를 수집하지 않으려는 경우에만 설정해야 합니다.	로컬 호스트	중
포트	Elasticsearch가 수신 대기 중인 포트입니다.	9200	미
사용자 이름	Elasticsearch Node에 액세스하기 위한 사용자 이름입니다.	해당 없음	미
비밀번호	지정된 사용자의 비밀번호입니다.	해당 없음	미
클러스터_환경	데이터를 수집할 클러스터를 추가로 지정하는 방법입니다(예: 'staging').	해당 없음	미
USE_SSL	Elasticsearch 노드와 통신할 때 SSL을 사용하십시오.	잘못된	미
CA_BUNDLE_FILE	호스트에서 SSL 인증서의 위치입니다. `USE_SSL` 이 true인 경우에만 필요합니다.	해당 없음	미
CA_BUNDLE_DIR	대체 인증 기관 번들 디렉토리.	해당 없음	미
SSL_ALTERNATIVE_HOSTNAME	SSL 협상을 위해 통합에서 유효한 것으로 수락할 대체 서버 호스트 이름입니다.	해당 없음	미
TLS_INSECURE_SKIP_VERIFY	서버의 인증서 체인 및 호스트 이름 확인을 건너뜁니다.	잘못된	미
CONFIG_PATH	Elasticsearch 구성 파일의 경로입니다.	/etc/elasticsearch/ Elasticsearch.yml	나
시간 초과	API 요청에 대한 제한 시간(초)입니다.	30	미
COLLECT_INDICES	인덱스 메트릭을 수집할지 여부를 나타냅니다.	진정한	중
COLLECT_PRIMARIES	기본 메트릭을 수집할지 여부를 나타냅니다.	진정한	중
INDEXES_REGEX	수집되는 인덱스를 필터링합니다.	해당 없음	중
MASTER_ONLY	선택된 마스터에서만 클러스터 메트릭을 수집합니다.	잘못된	중
측정항목	측정항목 전용 수집을 활성화하려면 `true` 으로 설정합니다.	잘못된
목록	인벤토리 전용 컬렉션을 활성화하려면 `true` 으로 설정합니다.	잘못된

이러한 설정의 값은 여러 가지 방법으로 정의할 수 있습니다.

구성 파일에 직접 값을 추가합니다. 이것은 가장 일반적인 방법입니다.
{{ }} 표기법을 사용하여 환경 변수의 값 바꾸기. 호스트 내 통합과 함께 환경 변수 패스스루 사용 에 대해 자세히 알아보거나 환경 변수 교체 에 대한 예를 참조하십시오.
중요
이를 위해서는 인프라 에이전트 v1.14.0 이상이 필요합니다.
비밀 관리를 사용합니다. 이를 사용하여 구성 파일에서 일반 텍스트로 노출될 암호와 같은 민감한 정보를 보호하십시오. 자세한 내용은 비밀 관리 를 참조하십시오.

라벨 및 사용자 정의 속성

레이블을 사용하여 메트릭을 추가로 꾸밀 수 있습니다. 레이블을 사용하면 키-값 쌍 속성을 메트릭에 추가할 수 있으며, 이 속성을 사용하여 메트릭을 쿼리, 필터링 또는 그룹화할 수 있습니다.
기본 구성 elasticsearch-config.yml 샘플 파일 에는 레이블 사용이 포함되어 있습니다. 그러나 필수 항목이 아니므로 원하는 항목을 제거, 수정 또는 추가할 수 있습니다.

labels:
   env: production
   role: load_balancer

인벤토리 데이터

Elasticsearch 통합은 YAML 구성 파일 에 지정된 대로 Elasticsearch 노드의 구성 매개변수를 캡처합니다. 또한 \_nodes/\_local 엔드포인트에서 노드 구성 정보를 수집합니다. 데이터는 config/elasticsearch 소스 아래의 인프라 인벤토리 페이지 에서 사용할 수 있습니다.

인벤토리 데이터에 대한 자세한 내용은 통합 데이터를 이해 하는 방법을 참조하세요.

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

호환성 및 요구 사항

Elasticsearch 버전

지원되는 운영 체제

시스템 요구 사항

통합 설치 및 활성화

리눅스 설치

기타 환경

윈도우 설치

' ' Amazon ECS 설치

쿠버네티스 설치

이 문서가 설치하는데 도움이 되셨나요?

통합 구성

중요

Elasticsearch-config.yml 샘플 파일

기본 구성

메트릭 및 인벤토리 간격이 다른 기본 구성

환경 변수 교체

클러스터 모니터링

통합을 위한 구성 옵션

데이터 찾기 및 사용

통합으로 수집된 측정항목

ElasticsearchClusterSample 이벤트

ElasticsearchNodeSample 이벤트

ElasticsearchCommonSample 이벤트

ElasticsearchIndexSample 이벤트

Elasticsearch 인스턴스 설정

중요

라벨 및 사용자 정의 속성

인벤토리 데이터

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

Elasticsearch 모니터링 통합

호환성 및 요구 사항 .css-21sua1{background:none;border:none;width:0;padding:0;}

Elasticsearch 버전

지원되는 운영 체제

시스템 요구 사항

통합 설치 및 활성화

리눅스 설치

기타 환경

' ' Amazon ECS 설치

쿠버네티스 설치

이 문서가 설치하는데 도움이 되셨나요?

통합 구성

중요

Elasticsearch-config.yml 샘플 파일

기본 구성

메트릭 및 인벤토리 간격이 다른 기본 구성

환경 변수 교체

클러스터 모니터링

통합을 위한 구성 옵션

데이터 찾기 및 사용

통합으로 수집된 측정항목

ElasticsearchClusterSample 이벤트

ElasticsearchNodeSample 이벤트

ElasticsearchCommonSample 이벤트

ElasticsearchIndexSample 이벤트

Elasticsearch 인스턴스 설정

중요

라벨 및 사용자 정의 속성

인벤토리 데이터

호환성 및 요구 사항