TiDBクラスタ監視サービスのアップグレード
TiDB クラスターをデプロイすると、 TiUP はクラスターの監視サービス (Prometheus、Grafana、Alertmanager など) を自動的にデプロイします。このクラスターをスケールアウトすると、 TiUP はスケーリング中に新しく追加されたノードの監視構成も自動的に追加します。TiUP によって自動的にデプロイされる監視サービスは、通常、これらのサードパーティ監視サービスの最新バージョンではありません。最新バージョンを使用するには、このドキュメントに従って監視サービスをアップグレードしてください。
クラスターを管理する際、 TiUP は独自の構成を使用して監視サービスの構成を上書きします。構成ファイルを置き換えて監視サービスを直接アップグレードすると、クラスターでの後続のTiUP操作scale-out deploy reload ) によってアップグレードが上書きscale-inれ、エラーが発生する可能性があります。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インストールパッケージをダウンロードします。
Prometheus ダウンロードページから新しいインストール パッケージをダウンロードして解凍します。
ステップ2. TiDBが提供するPrometheusインストールパッケージをダウンロードする
TiDBサーバーパッケージをダウンロードして解凍します。ダウンロードすると、 プライバシーポリシーに同意したことになります。
https://download.pingcap.org/tidb-community-server-{version}-linux-{arch}.tar.gzヒント：
リンク内の
{version}TiDB のバージョン番号を示し、{arch}システムのアーキテクチャ(amd64またはarm64を示します。たとえば、amd64アーキテクチャのv7.5.3のダウンロード リンクはhttps://download.pingcap.org/tidb-community-toolkit-v7.5.3-linux-amd64.tar.gzです。抽出したファイルで、
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という名前を付けます。5{new-version}必要に応じて指定できます。cd prometheus-v{version}-linux-amd64 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 --overwrite
アップグレード後、Prometheusサーバーのホームページ (通常はhttp://<Prometheus-server-host-name>:9090 ) に移動し、上部のナビゲーション メニューで[ステータス]をクリックして、 [ランタイムとビルド情報]ページを開き、Prometheus のバージョンを確認し、アップグレードが成功したかどうかを確認できます。
Grafana のアップグレード
TiDB との互換性を高めるために、TiDB インストール パッケージで提供される Grafana インストール パッケージを使用することをお勧めします。TiDB インストール パッケージ内の Grafana のバージョンは固定されています。より新しいバージョンの Grafana を使用する場合は、各バージョンの新機能についてはGrafana リリースノートを参照し、本番環境に適したバージョンを選択してください。推奨バージョンについては、PingCAP の技術スタッフに問い合わせることもできます。
次のアップグレード手順では、Grafana Web サイトから必要なバージョンの Grafana インストール パッケージをダウンロードし、それを使用してTiUPが使用できる Grafana パッケージを作成する必要があります。
ステップ1. GrafanaのWebサイトから新しいGrafanaインストールパッケージをダウンロードします。
- Grafana ダウンロードページから新しいインストール パッケージをダウンロードします。 必要に応じて、
OSSまたはEnterpriseエディションを選択できます。 - ダウンロードしたパッケージを解凍します。
ステップ2. TiDBが提供するGrafanaインストールパッケージをダウンロードする
TiDBサーバーパッケージをダウンロードして解凍します。ダウンロードすると、 プライバシーポリシーに同意したことになります。
https://download.pingcap.org/tidb-community-server-{version}-linux-{arch}.tar.gzヒント：
リンク内の
{version}TiDB のバージョン番号を示し、{arch}システムのアーキテクチャ(amd64またはarm64を示します。たとえば、amd64アーキテクチャのv7.5.3のダウンロード リンクはhttps://download.pingcap.org/tidb-community-toolkit-v7.5.3-linux-amd64.tar.gzです。抽出したファイルで、
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という名前を付けます。5{new-version}必要に応じて指定できます。cd grafana-v{version}-linux-amd64 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 --overwrite
アップグレード後、Grafanaサーバーのホームページ (通常はhttp://<Grafana-server-host-name>:3000 ) に移動し、ページで Grafana のバージョンを確認して、アップグレードが成功したかどうかを確認できます。
Alertmanager のアップグレード
TiDB インストール パッケージ内の Alertmanager パッケージは、Prometheus Web サイトから直接提供されます。したがって、Alertmanager をアップグレードする場合は、Prometheus Web サイトから新しいバージョンの Alertmanager をダウンロードしてインストールするだけで済みます。
ステップ1. PrometheusのWebサイトから新しいAlertmanagerインストールパッケージをダウンロードします。
Prometheus ダウンロードページからalertmanagerインストール パッケージをダウンロードします。
ステップ2. ダウンロードしたインストールパッケージを使用してAlertmanagerをアップグレードする
Alertmanager をアップグレードするには、次のコマンドを実行します。
tiup cluster patch <cluster-name> alertmanager-v{new-version}-linux-amd64.tar.gz -R alertmanager --overwrite
アップグレード後、Alertmanagerサーバーのホームページ (通常はhttp://<Alertmanager-server-host-name>:9093 ) に移動し、上部のナビゲーション メニューで[ステータス]をクリックして、Alertmanager のバージョンを確認し、アップグレードが成功したかどうかを確認できます。