# 모니터링 설정

## Overview <a href="#overview" id="overview"></a>

Klaytn 팀은 Klaytn CCN을 모니터링할 수 있는 사이트(<http://cypress.klaytn.net:3000>)를 제공합니다. `telegraf` 모니터링 에이전트는 CC의 각 CN/PN에 설치되어 지표를 수집하고 이를 모니터링 서버로 보냅니다. 일단 설치되면 모니터링 사이트를 방문하여 Klaytn CC의 지표들을 볼 수 있습니다.

설치 과정은 다음과 같습니다.

1. CN/PN에서 `telegraf` 설치하기
2. `telegraf` 환경설정하기
3. `telegraf` 시작하기

## Telegraf 설치 <a href="#telegraf-installation" id="telegraf-installation"></a>

Telegraf 설치 안내서 (Amazon Linux 2 사용자, 아래 참조): <https://docs.influxdata.com/telegraf/latest/introduction/installation/>

**Amazon Linux 2에 대한 참고 사항**

Amazon Linux 2에 Telegraph를 설치하려면, 다음과 같이 InfluxData의 RHEL 7 yum repo를 사용해야 합니다:

```
cat <<EOF | sudo tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL 7
baseurl = https://repos.influxdata.com/rhel/7/\$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF
```

## Telegraf 설정 <a href="#telegraf-setup" id="telegraf-setup"></a>

### kcnd/kpnd에서 모니터링 활성화 <a href="#enable-monitoring-in-kcnd-kpnd" id="enable-monitoring-in-kcnd-kpnd"></a>

/etc/kcnd/conf/kcnd.conf

```
...
METRICS=1
PROMETHEUS=1
...
```

**Check**

포트 61001이 열려 있는지 확인하여 위의 두 가지 옵션이 활성화되어 있는지 확인할 수 있습니다.

```
$ netstat -ntap | grep 61001
tcp        0      0 :::61001        :::*       LISTEN      8989/kcn
```

**Telegraf 서비스 환경설정**

다음 파일을 `telegraf` 환경설정 디렉토리 (`/etc/telegraf/telegraf.d/`)에 복사하고, `nodetype`, `instance`, `hostname`를 각 노드에 적합하게 수정하세요.

```
[global_tags]
  # Change "cn" to "pn" for PN installation
  nodetype = "cn"

  # The CN/PN name (e.g. `example-cn`, `example-pn`)
  instance = "<hostname>"

[agent]
  # The CN/PN name (e.g. `example-cn`, `example-pn`)
  hostname = "<hostname>"

[[outputs.influxdb]]
  urls = [ "http://localhost:" ]
  database = "klaytn_cypress"

[[inputs.prometheus]]
  urls = [ "http://localhost:61001/metrics" ]
```

`/etc/telegraf/telegraf.conf`에서 다음을 변경하세요:

* `[[outputs.influxdb]]` 장을 주석 처리 하세요.

**Telegraf 시작하기**

```
$ systemctl restart telegraf
```

## Grafana <a href="#grafana" id="grafana"></a>

각 CN/PN이 위의 환경설정 및 에이전트를 가진 경우, 다음 URL에서 지표들을 확인할 수 있습니다.

<http://cypress.klaytn.net:3000>

CC 운영자는 슬랙 채널에 회사 이름과 이메일 주소를 제공하시고 계정을 요청할 수 있습니다. CC 운영자만이 Grafana 계정을 요청할 수 있습니다.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://archive-ko.docs.klaytn.foundation/content/installation-guide/deployment/core-cell/monitoring-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.