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アーキテクチャのv8.1.0のダウンロードリンクはhttps://download.pingcap.org/tidb-community-toolkit-v8.1.0-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

アップグレード後、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アーキテクチャのv8.1.0のダウンロードリンクはhttps://download.pingcap.org/tidb-community-toolkit-v8.1.0-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

アップグレード後、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

アップグレード後、Alertmanagerサーバーのホームページ (通常はhttp://<Alertmanager-server-host-name>:9093 ) に移動し、上部のナビゲーションメニューで[ステータス]をクリックして、Alertmanager のバージョンを確認し、アップグレードが成功したかどうかを確認できます。