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

Private Cloud용 Edge v. 4.17.09

시스템 요구사항

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

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

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

다음 인스턴스의 자체 노드에 apigee-influxdb를 설치하기로 결정하면 노드 요구사항은 다음과 같습니다.

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

InfluxData 문서를 참조하세요.

apigee-influxdb의 포트 요구사항

igee-influxdb 데이터 노드에 포트 8086 및 8183이 열려 있어야 Apigee-grafana를 실행하는 노드 Apigee-telegraf

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

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 노드에서 다음을 실행합니다.

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

apigee-telegraf를 설치합니다. 모든 Edge 노드

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

  1. 첫 번째 Edge 노드에 apigee-telegraf를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 설치
  2. sa_telegraf.txt라는 이름의 apigee-telegraf에 대한 구성 파일을 만듭니다. 일반적으로 이 파일은 'apigee'가 액세스할 수 있는 디렉터리에 저장합니다. 사용자에게 서비스 이름: /opt/apigee/customer/application 이를 'Apigee'가 소유하도록 설정할 수 있습니다 있습니다.

    파일에서 다음 속성을 설정하여 apigee-influxdb 노드의 URL을 지정하세요. 포트 8086 포함:
    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 설정 -f /opt/apigee/customer/application/sa_telegraf.txt
  5. apigee-telegraf를 다시 시작합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 다시 시작
  6. 모든 에지 노드에서 이 프로세스를 반복합니다.

Apigee-grafana 설치 단일 Edge 노드와

Edge 설치의 단일 노드(예: Edge UI 노드)에서 다음을 수행합니다.

  1. 첫 번째 Edge 노드에 apigee-grafana를 설치합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 설치
  2. 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
  3. 소유자를 'Apigee'로 변경합니다.
    > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
  4. apigee-grafana 구성 구성 파일 사용:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 설정 -f /opt/apigee/customer/application/sa_grafana.txt
  5. apigee-grafana를 다시 시작합니다.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 재시작

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

http://grafana_IP_or_DNS:3000

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

설치 문제 해결

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

  1. Apigee-telegraf가 보장되도록 하려면 다음 안내를 따르세요. 데이터를 수집하고 있습니다. <ph type="x-smartling-placeholder">
      </ph>
    1. apigee-service를 실행합니다. Apigee-telegraf 설정은 멱등성이 있으며 오류, 종속 항목 누락을 확인합니다. 해결할 수 있습니다
    2. apigee-telegraf를 다시 시작합니다. /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log를 확인하세요. 모든 오류 확인
  2. 보장 요건: apigee-influxdb 수신 중: <ph type="x-smartling-placeholder">
      </ph>
    1. apigee-influxdb 데이터 노드에 다음 TCP 포트 8086이 열려 있는지 확인하세요. 8183입니다.
    2. 다음 URL을 사용하여 브라우저에서 influxdb UI를 엽니다.
      http://influxdb_IP_or_DNS:8183
      1. 쿼리 필드에 '데이터베이스 표시'를 입력합니다.
        시스템, 애플리케이션, 이벤트, 데이터베이스와 같은 데이터베이스가 생성되었는지 확인합니다. _internal이 있습니다.
      2. 쿼리 필드에 'show 서버'를 입력합니다.
        apigee-influxdb 노드가 표시되는지 확인하세요. 선택합니다.
  3. 대시보드에서 데이터 소스를 확인합니다. <ph type="x-smartling-placeholder">
      </ph>
    1. 기본 메뉴에서 데이터 소스를 선택합니다. 세 개의 광고 항목에 대한 데이터 소스가 표시됩니다.
    2. 각 데이터 소스에서 아이콘을 선택합니다.
    3. 데이터 소스의 세부정보 페이지에서 저장 및 테스트 버튼을 클릭합니다.
    4. 데이터 소스가 올바르게 구성되면
      형식의 메시지가 표시됩니다. 성공
      데이터 소스가 작동 중입니다.

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

업그레이드할 Edge 버전에 따라 아래의 두 절차 중 하나를 사용하세요.

  • 4.16.09, 4.17.01, 4.17.05는 동일한 절차를 사용합니다.
  • 4.16.05 버전에서는 업데이트의 일환으로 apigee-collectd를 제거해야 합니다.

업데이트 출처: 버전 4.16.09, 4.17.01, 4.17.05

4.16.09, 4.17.01 또는 4.17.05용 베타 버전으로 업데이트할 수 있습니다.

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

  1. Apigee Edge 4.17.01/4.17.05를 4.17.09로 업데이트에 설명된 대로 Edge를 4.17.09로 업데이트합니다. Apigee Edge 4.16.09를 4.17.09로 업데이트 Apigee Edge 4.16.01/4.16.05를 4.17.09.
  2. Apigee-influxdb에서 apigee-influxdb를 업데이트합니다. 관리 서버 노드:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
    <ph type="x-smartling-placeholder">
    </ph> 여기서 configFile은 설치에 사용한 구성 파일입니다. apigee-influx

    관리 환경에 apigee-grafana도 설치한 경우 서버 노드이면 이 단계로 apigee-grafana도 업데이트됩니다. 그렇지 않으면 Apigee-granfana는 다음 단계를 따르세요.
  3. 서비스에 apigee-grafana를 설치하지 않은 경우 관리 서버 노드에서 구성하려는 노드에서 apigee-grafana를 업데이트하세요. 설치:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. Apigee에서 apigee-telegraf를 업데이트합니다. 노드 1:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 업데이트
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 설정 -f configFile
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 다시 시작
  5. 모든 노드에 대해 4단계를 반복합니다.

버전에서 업데이트 4.16.05

4.16.05 버전의 대시보드에서는 apigee-telegraf 대신 apigee-collectd를 사용했습니다. 업데이트의 일부로 4.17.09에서는 apigee-collectd를 제거하고 apigee-telegraf를 설치합니다.

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

  1. Apigee Edge 4.17.01/4.17.05를 4.17.09로 업데이트에 설명된 대로 Edge를 4.17.09로 업데이트합니다. Apigee Edge 4.16.09를 4.17.09로 업데이트 Apigee Edge 4.16.01/4.16.05를 4.17.09.
  2. Apigee-influxdb에서 apigee-influxdb를 업데이트합니다. 관리 서버 노드:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
    <ph type="x-smartling-placeholder">
    </ph> 여기서 configFile은 설치에 사용한 구성 파일입니다. apigee-influx

    관리 환경에 apigee-grafana도 설치한 경우 서버 노드이면 이 단계로 apigee-grafana도 업데이트됩니다. 그렇지 않으면 Apigee-granfana는 다음 단계를 따르세요.
  3. 서비스에 apigee-grafana를 설치하지 않은 경우 관리 서버 노드에서 구성하려는 노드에서 apigee-grafana를 업데이트하세요. 설치:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
  4. 노드 1에 apigee-telegraf를 설치합니다.
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 중지
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 설치
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 설정 -f configFile
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 다시 시작
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 제거
  5. 모든 노드에 대해 4단계를 반복합니다.