TiDBクラスタ監視サービスのアップグレード
TiDB クラスターをデプロイする場合、 TiUP はクラスターの監視サービス (Prometheus、Grafana、Alertmanager など) を自動的にデプロイします。このクラスターをスケールアウトすると、 TiUP はスケーリング中に新しく追加されたノードの監視構成も自動的に追加します。 TiUPによって自動的に展開される監視サービスは、通常、これらのサードパーティ監視サービスの最新バージョンではありません。最新バージョンを使用するには、このドキュメントに従って監視サービスをアップグレードします。
クラスターを管理する場合、 TiUP は独自の構成を使用して監視サービスの構成をオーバーライドします。構成ファイルを置き換えることによってモニタリング サービスを直接アップグレードすると、クラスター上での後続のTiUP操作 ( deploy 、 scale-out 、 scale-in 、 reloadなど) によってアップグレードが上書きされ、エラーが発生する可能性があります。 Prometheus、Grafana、および Alertmanager をアップグレードするには、構成ファイルを直接置き換えるのではなく、このドキュメントの手順に従ってください。
注記：
- TiUPを使用せずに監視サービスが手動でデプロイされるの場合は、このドキュメントを参照せずに直接アップグレードできます。
- TiDB と監視サービスの新しいバージョンとの互換性はテストされていないため、アップグレード後に一部の機能が期待どおりに動作しない可能性があります。問題がある場合は、GitHub で問題を作成してください。
- このドキュメントのアップグレード手順は、 TiUPバージョン 1.9.0 以降に適用されます。したがって、アップグレードする前にTiUP のバージョンを確認してください。
- TiUPを使用して TiDB クラスターをアップグレードすると、 TiUP はモニタリング サービスをデフォルト バージョンに再デプロイします。 TiDB のアップグレード後に、モニタリング サービスのアップグレードをやり直す必要があります。
プロメテウスをアップグレードする
TiDB との互換性を高めるために、TiDB インストール パッケージで提供される Prometheus インストール パッケージを使用することをお勧めします。 TiDB インストール パッケージ内の Prometheus のバージョンは修正されました。新しい Prometheus バージョンを使用する場合は、各バージョンの新機能についてプロメテウス リリースノートを参照し、本番環境に適したバージョンを選択してください。推奨バージョンについては、PingCAP 技術スタッフに問い合わせることもできます。
次のアップグレード手順では、Prometheus Web サイトから目的のバージョンの Prometheus インストール パッケージをダウンロードし、それを使用してTiUPが使用できる Prometheus パッケージを作成する必要があります。
ステップ 1. Prometheus Web サイトから新しい Prometheus インストール パッケージをダウンロードします。
プロメテウスのダウンロードページから新しいインストールパッケージをダウンロードして解凍します。
ステップ 2. TiDB が提供する Prometheus インストール パッケージをダウンロードする
TiDBダウンロードページから TiDBサーバー パッケージをダウンロードして解凍します。
抽出されたファイルで
prometheus-v{version}-linux-amd64.tar.gz見つけて抽出します。tar -xzf prometheus-v{version}-linux-amd64.tar.gz
ステップ 3. TiUPが使用できる新しい Prometheus パッケージを作成する
ステップ1で解凍したファイルをコピーし、 ステップ2で解凍した
./prometheus-v{version}-linux-amd64/prometheusディレクトリ内のファイルをコピーしたファイルで置き換えます。./prometheus-v{version}-linux-amd64ディレクトリを再圧縮し、新しい圧縮パッケージにprometheus-v{new-version}.tar.gzという名前を付けます。必要に応じて{new-version}を指定できます。cd prometheus-v{version}-linux-amd64.tar.gz tar -zcvf ../prometheus-v{new-version}.tar.gz ./
ステップ 4. 新しく作成した Prometheus パッケージを使用して Prometheus をアップグレードする
次のコマンドを実行して Prometheus をアップグレードします。
tiup cluster patch <cluster-name> prometheus-v{new-version}.tar.gz -R prometheus
アップグレード後、Prometheusサーバーのホームページ (通常はhttp://<Prometheus-server-host-name>:9090 ) に移動し、上部のナビゲーション メニューで[ステータス]をクリックし、[**ランタイムとビルド情報]**ページを開いて Prometheus のバージョンを確認し、アップグレードが成功したかどうかを確認できます。 。
グラファナをアップグレードする
TiDB との互換性を高めるために、TiDB インストール パッケージで提供される Grafana インストール パッケージを使用することをお勧めします。 TiDB インストール パッケージ内の Grafana のバージョンは修正されました。新しい Grafana バージョンを使用する場合は、各バージョンの新機能についてGrafana リリースノートを参照し、本番環境に適したバージョンを選択してください。推奨バージョンについては、PingCAP 技術スタッフに問い合わせることもできます。
次のアップグレード手順では、目的のバージョンの Grafana インストール パッケージを Grafana Web サイトからダウンロードし、それを使用してTiUPが使用できる Grafana パッケージを作成する必要があります。
ステップ 1. Grafana Web サイトから新しい Grafana インストール パッケージをダウンロードします。
- グラファナのダウンロードページから新しいインストール パッケージをダウンロードします。ニーズに応じて
OSSまたはEnterpriseエディションのいずれかを選択できます。 - ダウンロードしたパッケージを解凍します。
ステップ 2. TiDB が提供する Grafana インストール パッケージをダウンロードする
TiDBダウンロードページから TiDB Server Packageパッケージをダウンロードして解凍します。
抽出されたファイルで
grafana-v{version}-linux-amd64.tar.gz見つけて抽出します。tar -xzf grafana-v{version}-linux-amd64.tar.gz
ステップ 3. TiUPが使用できる新しい Grafana パッケージを作成する
ステップ1で解凍したファイルをコピーし、 ステップ2で解凍した
./grafana-v{version}-linux-amd64/ディレクトリ内のファイルをコピーしたファイルで置き換えます。./grafana-v{version}-linux-amd64ディレクトリを再圧縮し、新しい圧縮パッケージにgrafana-v{new-version}.tar.gzという名前を付けます。必要に応じて{new-version}を指定できます。cd grafana-v{version}-linux-amd64.tar.gz tar -zcvf ../grafana-v{new-version}.tar.gz ./
ステップ 4. 新しく作成した Grafana パッケージを使用して Grafana をアップグレードする
次のコマンドを実行して Grafana をアップグレードします。
tiup cluster patch <cluster-name> grafana-v{new-version}.tar.gz -R grafana
アップグレード後、Grafanaサーバーのホームページ (通常はhttp://<Grafana-server-host-name>:3000 ) に移動し、ページ上の Grafana バージョンをチェックしてアップグレードが成功したかどうかを確認できます。
アラートマネージャーのアップグレード
TiDB インストール パッケージ内の Alertmanager パッケージは、Prometheus Web サイトから直接取得されます。したがって、Alertmanager をアップグレードする場合は、Prometheus Web サイトから新しいバージョンの Alertmanager をダウンロードしてインストールするだけで済みます。
ステップ 1. Prometheus Web サイトから新しい Alertmanager インストール パッケージをダウンロードします。
プロメテウスのダウンロードページからalertmanagerインストール パッケージをダウンロードします。
ステップ 2. ダウンロードしたインストール パッケージを使用して Alertmanager をアップグレードする
次のコマンドを実行して、Alertmanager をアップグレードします。
tiup cluster patch <cluster-name> alertmanager-v{new-version}-linux-amd64.tar.gz -R alertmanager
アップグレード後、Alertmanagerサーバーのホームページ (通常はhttp://<Alertmanager-server-host-name>:9093 ) に移動し、上部のナビゲーション メニューで[ステータス]をクリックし、Alertmanager のバージョンをチェックしてアップグレードが成功したかどうかを確認できます。