Private Cloud용 Edge v. 4.17.05
시스템 요건
대시보드 데이터를 수집하려면 모든 Edge 노드에 apigee-telegraf를 설치해야 합니다. 따라서 apigee-telegraf의 시스템 요구사항은 설치할 Edge 노드의 시스템 요구사항과 동일합니다.
별도의 노드에 apigee-grafana를 설치하거나 관리 서버 또는 Edge UI 노드와 같은 기존 Edge 노드 중 하나를 재사용할 수 있습니다.
apigee-influxdb의 경우 시스템 요구사항을 변경하지 않고도 관리 서버 노드 또는 Edge UI 노드와 같은 기존 Edge 노드에 이를 설치할 수 있습니다.
성능상의 이유로 자체 노드에 apigee-influxdb를 설치하려는 경우 노드의 요구사항은 다음과 같습니다.
- 2코어 CPU
- RAM 4GB
- 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라는 텍스트 파일에 설정합니다.
속성 |
설명 |
---|---|
INFLUXDB_URL |
포트 8086을 포함하여 apigee-influxdb 노드의 URL을 지정하세요. 예를 들면 다음과 같습니다. http://192.168.0.1:8086 |
apigee-grafana의 구성 매개변수
apigee-grafana setup 명령어에 전달할 텍스트 파일에 이러한 속성을 설정합니다. 예를 들어 sa_grafana.txt라는 텍스트 파일에 다음과 같이 설정합니다.
속성 |
설명 |
---|---|
INFLUXDB_HOST |
InfluxDB 노드의 IP 주소 또는 DNS 이름을 지정합니다. 예를 들어 다음과 같습니다. 192.168.0.1 |
INFLUXDB_PORT |
Grafana 데이터 소스에서 사용하는 InfluxDB API 포트입니다. 8086을 지정합니다. |
GRAFANA_USERNAME |
대시보드 UI에 로그인하기 위한 Grafana 사용자 이름입니다. |
GRAFANA_PASSWORD |
대시보드 UI에 로그인하기 위한 Grafana 비밀번호입니다. |
설치 안내
아래 안내에 따라 이 순서대로 대시보드 구성요소를 설치합니다.
- apigee-influxdb (중앙 노드에서)
- apigee-telegraf (각 노드에서)
- apigee-grafana (중앙 서버에)
단일 Edge 노드 또는 독립형 노드에 apigee-influxdb를 설치합니다.
독립형 노드 또는 관리 서버나 Edge UI를 실행하는 Edge 노드에서 다음을 실행합니다.
- apigee-influxdb를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install - apigee-influxdb 데이터베이스를 구성합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup - apigee-influxdb를 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
모든 Edge 노드에 apigee-telegraf 설치
Edge 설치의 모든 노드에서 다음을 수행합니다.
- 첫 번째 Edge 노드에 apigee-telegraf를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - 이름이 sa_telegraf.txt인 apigee-telegraf의 구성 파일을 만듭니다.
일반적으로 이 파일은 'apigee' 사용자가 액세스할 수 있는 디렉터리(예: /opt/apigee/customer/application)에 저장하고 'apigee' 사용자가 소유하도록 합니다.
파일에서 다음 속성을 설정하여 포트 8086을 포함하여 apigee-influxdb 노드의 URL을 지정합니다.
INFLUXDB_URL=http://influx_IP:8086 - 소유자를 'apigee'로 변경합니다.
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - apigee-telegraf를 구성합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt - apigee-telegraf를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart - 모든 Edge 노드에서 이 프로세스를 반복합니다.
단일 Edge 노드에 apigee-grafana 설치
Edge UI 노드와 같은 Edge 설치의 단일 노드에서 다음을 수행합니다.
- 첫 번째 Edge 노드에 apigee-grafana를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - 이름이 sa_grafana.txt인 apigee-grafana의 구성 파일을 만듭니다. 일반적으로 이 파일은 'apigee' 사용자가 액세스할 수 있는 디렉터리(예: /opt/apigee/customer/application)에 저장하고 'apigee' 사용자가 소유하도록 합니다.
파일에서 다음 속성을 설정합니다. 이러한 속성은 위에 설명되어 있습니다.
INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin - 소유자를 'apigee'로 변경합니다.
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - 구성 파일을 사용하여 apigee-grafana를 구성합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt - apigee-grafana를 다시 시작합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
대시보드에 액세스하려면 브라우저에서 다음 URL을 엽니다.
http://grafana_IP_or_DNS:3000
apigee-grafana의 구성 파일에 지정한 사용자 인증 정보를 사용하여 로그인합니다. 위의 예에서 사용자 이름/비밀번호는 admin/admin입니다.
설치 문제 해결
대시보드에 데이터가 표시되지 않으면 다음 절차에 따라 설치 문제를 해결합니다.
- apigee-telegraf가 데이터를 수집하는지 확인하려면
- 멱등성이 있는 apigee-service apigee-telegraf setup을 실행하여 오류와 누락된 종속 항목을 확인하고 해결하세요.
- apigee-telegraf를 다시 시작하고 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log에 오류가 있는지 확인합니다.
- apigee-influxdb가 데이터를 수신하는지 확인하려면 다음을 실행합니다.
- apigee-influxdb 데이터 노드에서 TCP 포트 8086 및 8183이 열려 있는지 확인하세요.
- 다음 URL을 사용하여 브라우저에서 influxdb UI를 엽니다.
http://influxdb_IP_or_DNS:8183- 쿼리 필드에 '데이터베이스 표시'를 입력합니다.
system, application, events, _internal 데이터베이스가 생성되었는지 확인합니다. - 쿼리 필드에 'show server(서버 표시)'를 입력합니다.
apigee-influxdb 노드가 나열되어 있는지 확인하세요.
- 쿼리 필드에 '데이터베이스 표시'를 입력합니다.
- 데이터 소스를 대시보드에서 확인합니다.
- 기본 메뉴에서 데이터 소스를 선택합니다. 그러면 세 개의 데이터 소스에 대한 아이콘이 표시됩니다.
- 각 데이터 소스에서 아이콘을 선택합니다.
- 데이터 소스의 세부정보 페이지에서 저장 및 테스트 버튼을 선택합니다.
- 데이터 소스가 올바르게 구성되었으면 다음 형식의 메시지가 표시됩니다.
성공
데이터 소스가 작동 중입니다.
베타 모니터링 대시보드 업데이트 중
업그레이드할 Edge 버전에 따라 아래 두 절차 중 하나를 사용합니다.
- 4.16.09와 4.17.01에서 동일한 절차를 사용합니다.
- 4.16.05 업데이트의 일부로 apigee-collectd를 제거해야 합니다.
버전 4.16.09 또는 4.17.01에서 업데이트
4.16.09 또는 4.17.01에서 Apigee Monitoring 대시보드의 베타 버전을 설치한 경우 4.17.05의 베타 버전으로 업데이트할 수 있습니다.
베타 모니터링 대시보드를 업데이트하려면 다음 안내를 따르세요.
- Apigee Edge 4.17.01을 4.17.05로 업데이트, Apigee Edge 4.16.09를 4.17.05로 업데이트, Apigee Edge 4.16.01/4.16.05를 4.17.05로 업데이트에 설명된 대로 Edge를 4.17.05로 업데이트합니다.
- 관리 서버 노드에서 apigee-influxdb를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
여기서 configFile은 apigee-influx를 설치하는 데 사용한 구성 파일입니다.
관리 서버 노드에 apigee-grafana도 설치한 경우 이 단계에서 apigee-grafana도 업데이트됩니다. 그렇지 않으면 다음 단계와 같이 apigee-granfana를 업데이트합니다. - 관리 서버 노드에 apigee-grafana를 설치하지 않은 경우, 설치한 노드에서 apigee-grafana를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - 노드 1에서 apigee-telegraf를 업데이트합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
> /opt/apigee/apigee-service/bin/apigee-f - 모든 노드에 대해 4단계를 반복합니다.
버전 4.16.05에서 업데이트
대시보드 4.16.05 버전에서 apigee-telegraf 대신 apigee-collectd를 사용했습니다. 4.17.05로 업데이트하는 과정에서 apigee-collectd를 제거하고 apigee-telegraf를 설치합니다.
베타 모니터링 대시보드를 업데이트하려면 다음 안내를 따르세요.
- Apigee Edge 4.17.01을 4.17.05로 업데이트, Apigee Edge 4.16.09를 4.17.05로 업데이트, Apigee Edge 4.16.01/4.16.05를 4.17.05로 업데이트에 설명된 대로 Edge를 4.17.05로 업데이트합니다.
- 관리 서버 노드에서 apigee-influxdb를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
여기서 configFile은 apigee-influx를 설치하는 데 사용한 구성 파일입니다.
관리 서버 노드에 apigee-grafana도 설치한 경우 이 단계에서 apigee-grafana도 업데이트됩니다. 그렇지 않으면 다음 단계와 같이 apigee-granfana를 업데이트합니다. - 관리 서버 노드에 apigee-grafana를 설치하지 않은 경우, 설치한 노드에서 apigee-grafana를 업데이트합니다.
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile - 노드 1에 apigee-telegraf를 설치합니다.
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f apigee-service apigee-telegraf setup -f - 모든 노드에 대해 4단계를 반복합니다.