> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agens.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# トラブルシュート

> Agens セルフホスト版でよくある問題と確認方法です。

## Pod の確認

```bash theme={null}
kubectl -n agens get pods
kubectl -n agens describe pod <pod-name>
kubectl -n agens logs <pod-name> --tail=200
```

## Bootstrap job が失敗する

Job とログを確認します。

```bash theme={null}
kubectl -n agens get jobs
kubectl -n agens describe job agens-bootstrap
kubectl -n agens logs job/agens-bootstrap --tail=200
```

よくある原因:

* データベースに接続できない
* migration が失敗している
* provider または endpoint の seed data が不足している
* 必須 Secret が不足している

## 新しい image が反映されない

deployment が `:latest` と `imagePullPolicy: IfNotPresent` を使っている場合、Kubernetes が cached image を再利用することがあります。

実行中の image digest を確認します。

```bash theme={null}
kubectl -n agens get pod -l app.kubernetes.io/component=web \
  -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{.status.containerStatuses[0].imageID}{"\n"}{end}'
```

更新時に digest を明示します。

```bash theme={null}
kubectl -n agens set image deployment/agens-web \
  web=<image>@sha256:<digest>
```

## SSL handshake failed

TLS 証明書と Ingress の状態を確認します。

```bash theme={null}
kubectl -n agens get ingress
kubectl -n agens get managedcertificate
kubectl -n agens describe managedcertificate <name>
```

マネージド証明書を使っている場合は、証明書が有効になるまで待ってから再度アクセスしてください。

## ライセンスが未登録になる

Agens UI のライセンス画面でライセンスキーを登録してください。

Secret でライセンスキーを事前設定している場合は、Secret が存在することと、キー変更後に workload を再起動していることを確認します。

```bash theme={null}
kubectl -n agens get secret agens-license
kubectl -n agens rollout restart deploy/agens-web deploy/agens-server
```

## サービス連携が表示されない

bootstrap job が完了し、provider data が投入されていることを確認します。その後、web のログを確認します。

```bash theme={null}
kubectl -n agens logs deploy/agens-web --tail=200
```