Edge for Private Cloud v. 4.17.09
システム要件
すべての Edge ノードに apigee-telegraf をインストールして、 ダッシュボードデータを収集できます。したがって、apigee-telegraf のシステム要件は Edge と同じです。 インストール先のノードを選択します。
apigee-grafana をインストールします。 Management Server や Edge などの既存の Edge ノードの 1 つを再利用することも UI ノード。
apigee-influxdb には、 Management Server ノードや Edge UI ノードなどの既存の Edge ノードに、既存の Edge ノードに システム要件に変更はありません。
apigee-influxdb を独自のノードにインストールし、 パフォーマンス上の理由がある場合、ノードは次の要件を満たす必要があります。
- 2 コアの CPU
- 4 GB RAM
- 250GB のディスク容量(モニタリングデータは 1 か月後にパージ)
- 1,000 以上の IOPS
詳しくは、 InfluxData のドキュメントをご覧ください。
apigee-influxdb のポート要件
apigee-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 |
apigee-influxdb ノードの URL を指定します(ポート 8086 を含む)。 例: 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
スタンドアロン ノード、または Management Server または 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 設定 - apigee-influxdb を起動します。
>/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
apigee-telegraf を すべての
Edge 環境のすべてのノードで、次の操作を行います。
- 最初の Edge ノードに apigee-telegraf をインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf インストール - apigee-telegraf の構成ファイルを sa_telegraf.txt という名前で作成します。通常、このオブジェクトは
「apigee」からアクセスできるディレクトリに(/opt/apigee/customer/application など)して、「apigee」が所有するように設定します。できます。
ファイルで次のプロパティを設定して、apigee-influxdb ノードの URL を指定します。 (ポート 8086 を含む):
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 の再起動 - すべての Edge ノードでこのプロセスを繰り返します。
apigee-grafana を 単一のエッジノードに
Edge インストール環境の単一ノード(Edge UI ノードなど)で、次の操作を行います。
- 最初の Edge ノードに apigee-grafana をインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - apigee-grafana の構成ファイルを sa_grafana.txt という名前で作成します。通常、このファイルはディレクトリに保存し、
「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 の再起動
ダッシュボードにアクセスするには、ブラウザで次の URL を開きます。
http://grafana_IP_or_DNS:3000
apigee-grafana の構成ファイルで指定した認証情報を使用してログインします。上記の例では、 ユーザー名/パスワードが admin/admin です。
インストールのトラブルシューティング
ダッシュボードにデータが表示されない場合は、次の手順でトラブルシューティングを行ってください。 確認します。
- apigee-telegraf が
データを収集しています
<ph type="x-smartling-placeholder">
- </ph>
- apigee-service を実行します。 apigee-telegraf setup: べき等性、エラー、依存関係の欠落 解決できます
- apigee-telegraf を再起動します。 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log を確認します。 エラーがないか
- apigee-influxdb
次のデータを受信しています:
<ph type="x-smartling-placeholder">
- </ph>
- apigee-influxdb データノードで TCP ポート 8086 と 8086 が開いていることを確認します。 8183。
- 次の URL を使用して、ブラウザで influxdb UI を開きます。
http://influxdb_IP_or_DNS:8183- [クエリ] フィールドに「show databases」と入力します。
データベース system、application、events、 _internal。 - [クエリ] フィールドに「show servers」と入力します。
apigee-influxdb ノードが 表示されます。
- [クエリ] フィールドに「show databases」と入力します。
- データソースをダッシュボードに確認します。
<ph type="x-smartling-placeholder">
- </ph>
- メインメニューで [データソース] を選択します。3 つのアイコンが 表示されます。
- データソースごとにアイコンを選択します。
- データソースの詳細ページで、[保存してテスト ] ボタンを離します。
- データソースが正しく構成されている場合は、
という形式のメッセージが表示されます。 成功
データソースが機能しています
ベータ版モニタリング ダッシュボードの更新
アップグレード元の Edge のバージョンに応じて、以下の 2 つの手順のいずれかを使用します。
- 4.16.09、4.17.01、4.17.05 では同じ手順を使用
- 4.16.05 では、更新の一環として apigee-collectd をアンインストールする必要があります。
更新元 バージョン 4.16.09、4.17.01、または 4.17.05
ベータ版の Apigee Monitoring ダッシュボードを 4.16.09、4.17.01、または 4.17.05 から 4.17.09 のベータ版に更新できます。
ベータ版のモニタリング ダッシュボードを更新するには:
- Apigee Edge の更新の説明に沿って Edge を 4.17.09 に更新します。 4.17.01/4.17.05 から 4.17.09 への更新、Apigee Edge 4.16.09 を 4.17.09、Apigee Edge を更新する 4.16.01/4.16.05 ~ 4.17.09
- apigee-influxdb を更新する
Management Server ノード:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
ここで、configFile は apigee-influx のインストールに使用した構成ファイルです。
apigee-grafana を Management Server にもインストールした場合 その場合、この手順で apigee-grafana も更新されます。それ以外の場合は、 apigee-granfana を 見てみましょう。 - apigee-grafana をインストールしていない場合
、apigee-grafana を
インストール:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f 構成ファイル - apigee-telegraf を更新します。
ノード 1:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf の更新
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf の再起動 - ノードごとに手順 4 を繰り返します。
バージョンから更新 4.16.05
4.16.05 バージョンのダッシュボードでは、apigee-telegraf の代わりに apigee-collectd が使用されていました。バージョン 2 への 4.17.09 では、apigee-collectd をアンインストールし、apigee-telegraf をインストールします。
ベータ版のモニタリング ダッシュボードを更新するには:
- Apigee Edge の更新の説明に沿って Edge を 4.17.09 に更新します。 4.17.01/4.17.05 から 4.17.09 への更新、Apigee Edge 4.16.09 を 4.17.09、Apigee Edge を更新する 4.16.01/4.16.05 ~ 4.17.09
- apigee-influxdb を更新する
Management Server ノード:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
ここで、configFile は apigee-influx のインストールに使用した構成ファイルです。
apigee-grafana を Management Server にもインストールした場合 その場合、この手順で apigee-grafana も更新されます。それ以外の場合は、 apigee-granfana を 見てみましょう。 - apigee-grafana をインストールしていない場合
、apigee-grafana を
インストール:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f 構成ファイル - apigee-telegraf をインストールする
ノード 1:
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 停止
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf の再起動
>/opt/apigee/apigee-service/bin/apigee-service apigee-collectd アンインストール - ノードごとに手順 4 を繰り返します。