TiDBクラスタ監視サービスのアップグレード

TiDB クラスターをデプロイすると、 TiUP はクラスターの監視サービス（Prometheus、Grafana、Alertmanager など）を自動的にデプロイします。このクラスターをスケールアウトすると、 TiUP はスケーリング中に新しく追加されたノードの監視設定も自動的に追加します。TiUPTiUP自動的にデプロイされる監視サービスは、通常、これらのサードパーティ製監視サービスの最新バージョンではありません。最新バージョンを使用するには、こちらのドキュメントに従って監視サービスをアップグレードしてください。

クラスターを管理する際、 TiUP は独自の設定を使用して監視サービスの設定を上書きします。監視サービスの設定ファイルを置き換えて直接アップグレードすると、クラスター上でdeploy 、 scale-out 、 scale-in 、 reloadなどの後続のTiUP操作によってアップグレードが上書きされ、エラーが発生する可能性があります。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.5.3のダウンロードリンクはhttps://download.pingcap.org/tidb-community-toolkit-v8.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のウェブサイトから新しい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.5.3のダウンロードリンクはhttps://download.pingcap.org/tidb-community-toolkit-v8.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ウェブサイトから直接入手できます。そのため、Alertmanagerをアップグレードする場合は、Prometheusウェブサイトから新しいバージョンの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 のバージョンを確認し、アップグレードが成功したかどうかを確認できます。