베타 모니터링 대시보드 설치

프라이빗 클라우드용 Edge v. 4.17.01

시스템 요구사항

대시보드 데이터를 수집하려면 모든 Edge 노드에 apigee-telegraf를 설치해야 합니다. 따라서 apigee-telegraf의 시스템 요구사항은 설치하는 Edge 노드의 시스템 요구사항과 동일합니다.

별도의 노드에 apigee-grafana를 설치하거나 관리 서버 또는 Edge UI 노드와 같은 기존 Edge 노드 중 하나를 재사용할 수 있습니다.

apigee-influxdb의 경우 시스템 요구사항을 변경하지 않고 관리 서버 노드 또는 Edge UI 노드와 같은 기존 Edge 노드에 설치할 수 있습니다.

성능상의 이유로 자체 노드에 apigee-influxdb를 설치하기로 결정한 경우 노드에는 다음 요구사항이 있어야 합니다.

• 2코어 CPU
• 4GB RAM
• 디스크 공간 250GB (모니터링 데이터는 1개월 후 삭제됨)
• 1,000IOPS 이상

자세한 내용은 InfluxData 문서를 참조하세요.

apigee-influxdb의 포트 요구사항

apigee-grafana 및 apigee-telegraf를 실행하는 노드에서 액세스할 수 있도록 apigee-influxdb 데이터 노드에서 포트 8086 및 8183을 열어야 합니다.

대시보드 구성요소 설치를 위한 구성 파일

apigee-telegraf 및 apigee-grafana 구성요소를 설치하려면 구성 파일을 apigee-service 유틸리티에 전달합니다. 이러한 파일을 'apigee' 사용자가 액세스할 수 있는 디렉터리(예: /opt/apigee/customer/application)에 저장하고 'apigee' 사용자가 소유하도록 합니다.

apigee-telegraf의 구성 매개변수

apigee-telegraf setup 명령어에 전달하는 텍스트 파일에서 이러한 속성을 설정합니다. 예를 들어 sa_telegraf.txt라는 텍스트 파일에 설정합니다.

http://192.168.0.1:8086

apigee-grafana의 구성 매개변수

apigee-grafana setup 명령어에 전달하는 텍스트 파일에서 이러한 속성을 설정합니다. 예를 들어 sa_grafana.txt라는 텍스트 파일에 설정합니다.

192.168.0.1

설치 안내

아래 안내에 따라 다음 순서로 대시보드 구성요소를 설치합니다.

• apigee-influxdb (중앙 노드)
• apigee-telegraf (각 노드)
• apigee-grafana (중앙 서버)

단일 Edge 노드 또는 독립형 노드에 apigee-influxdb 설치

독립형 노드 또는 관리 서버 또는 Edge UI를 실행하는 Edge 노드에서 다음을 실행합니다.

1. apigee-influxdb를 설치합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. apigee-influxdb 데이터베이스를 구성합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. apigee-influxdb를 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

모든 Edge 노드에 apigee-telegraf 설치

Edge 설치의 모든 노드에서 다음을 실행합니다.

1. 첫 번째 Edge 노드에서 apigee-telegraf를 설치합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. apigee-telegraf의 구성 파일을 만듭니다. 일반적으로 이 파일을 'apigee' 사용자가 액세스할 수 있는 디렉터리(예: /opt/apigee/customer/application)에 저장하고 'apigee' 사용자가 소유하도록 합니다.
   
   파일에서 다음 속성을 설정하여 포트 8086을 포함한 apigee-influxdb 노드의 URL을 지정합니다.
   INFLUXDB_URL=http://influx_IP:8086
3. 소유자를 'apigee'로 변경합니다.
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. apigee-telegraf를 구성합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. apigee-telegraf를 다시 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. 모든 Edge 노드에서 이 프로세스를 반복합니다.

단일 Edge 노드에 apigee-grafana 설치

Edge UI 노드와 같은 Edge 설치의 단일 노드에서 다음을 실행합니다.

1. 첫 번째 Edge 노드에서 apigee-grafana를 설치합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. apigee-grafana의 구성 파일을 만듭니다. 일반적으로 이 파일은 'apigee' 사용자가 액세스할 수 있는 디렉터리(예: /opt/apigee/customer/application)에 저장하고 'apigee' 사용자가 소유하도록 합니다.
   
   파일에서 다음 속성을 설정합니다. 이러한 속성은 위에 설명되어 있습니다.
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. 소유자를 'apigee'로 변경합니다.
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. 구성 파일을 사용하여 apigee-grafana를 구성합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. apigee-grafana를 다시 시작합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

대시보드에 액세스하려면 브라우저에서 다음 URL을 엽니다.

http://grafana_IP_or_DNS:3000

apigee-grafana의 구성 파일에 지정한 사용자 인증 정보를 사용하여 로그인합니다. 위에 표시된 예시에서 사용자 이름/비밀번호는 admin/admin입니다.

설치 문제 해결

대시보드에 데이터가 표시되지 않으면 다음 절차를 사용하여 설치 문제를 해결하세요.

1. apigee-telegraf가 데이터를 수집하는지 확인하려면 다음 안내를 따르세요.
   1. apigee-service apigee-telegraf setup을 실행합니다. 이 명령어는 멱등성이며 오류, 누락된 종속 항목을 확인하고 해결합니다.
   2. apigee-telegraf를 다시 시작하고 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log에서 오류를 확인합니다.
2. apigee-influxdb가 데이터를 수신하는지 확인하려면 다음 안내를 따르세요.
   1. apigee-influxdb 데이터 노드에서 TCP 포트 8086 및 8183이 열려 있는지 확인합니다.
   2. 다음 URL을 사용하여 브라우저에서 influxdb UI를 엽니다.
      http://influxdb_IP_or_DNS:8183
      1. 쿼리 필드에 'show databases'를 입력합니다.
         system, application, events, _internal 데이터베이스가 생성되었는지 확인합니다.
      2. 쿼리 필드에 'show servers'를 입력합니다.
         apigee-influxdb 노드가 나열되는지 확인합니다.
3. 대시보드의 데이터 소스를 확인합니다.
   1. 기본 메뉴에서 데이터 소스를 선택합니다. 데이터 소스 3개의 아이콘이 표시됩니다.
   2. 각 데이터 소스에서 아이콘을 선택합니다.
   3. 데이터 소스의 세부정보 페이지에서 저장 및 테스트 버튼을 선택합니다.
   4. 데이터 소스가 올바르게 구성된 경우 다음과 같은 메시지가 표시됩니다.
      성공
      데이터 소스가 작동 중입니다.

베타 모니터링 대시보드 업데이트

4.16.09에서 Apigee Monitoring 대시보드의 베타 버전을 설치한 경우 4.17.01의 베타 버전으로 업데이트할 수 있습니다.

다음 순서로 대시보드 구성요소를 업데이트해야 합니다.

• apigee-influxdb
• 각 노드의 apigee-telegraf
• apigee-grafana

베타 모니터링 대시보드를 업데이트하려면 다음 안내를 따르세요.

1. Apigee Edge 4.16.01/4.16.05를 4.17.01로 업데이트 및 Apigee Edge 4.16.09를 4.17.01로 업데이트에 설명된 대로 Edge를 4.17.01로 업데이트합니다.
2. apigee-influxdb를 업데이트합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
3. 노드 1에서 apigee-telegraf를 업데이트합니다.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
4. 모든 노드에 대해 3단계를 반복합니다.
5. 업데이트 apigee-grafana:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart