---
title: OpenLM AI Proxy のトラブルシューティング
description: OpenLM AI Proxy の導入、OpenLM Platform への接続、クライアントのルーティングで発生しやすい問題を解決します。
product: OpenLM Platform
---

次の質問から、該当する症状を探してください。導入の手順については、[AI Proxy を導入する](https://www.openlm.com/documentation/ja/cloud/deployment-operations/ai-proxy/deployment)を参照してください。

## コンテナーが起動しないのはなぜですか。

ステータスとログを確認し、その後スタックを再起動します。

```bash
docker compose ps
docker compose logs <service>
docker compose down
docker compose up -d
```

`<service>` は、コンテナー名（例: API サービスや UI サービス）に置き換えてください。

## MongoDB が起動しないのはなぜですか。

起動時に MongoDB が終了する場合、保存されているデータが実行中の MongoDB バージョンと互換性がないのが通常の原因です。データボリュームを再作成してください。

:::danger[これは保存されているデータを削除します]

次のコマンドは MongoDB ボリュームを削除します。利用レコード、プロバイダーの設定、OpenLM Platform の接続、保存されている API キーが消去され、スタックは Broker Hub に新しいエージェントとして表示されます。データが必要な場合は、先にボリュームをバックアップしてください。

```bash
docker compose down -v
docker compose up -d
```

:::

## UI が 500 エラーを返すのはなぜですか。

API コンテナーが準備できていない場合や、誤って設定されている場合、UI は 500 エラーを返します。API が正常な状態になるまで数秒待ってから、再読み込みしてください。エラーが解消されない場合は、UI コンテナーのログを確認してください。

```bash
docker compose logs <ui-service>
```

## UI または API に到達できないのはなぜですか。

`docker-compose.yml` でマッピングしたポートをホストのファイアウォールが許可していること、および URL でそれらのポートを使用していることを確認してください。`docker compose ps` でコンテナーが実行中であることを確認してください。

## API コンテナーが起動直後に停止するのはなぜですか。

API は `ENCRYPTION_KEY` 設定がないと起動しません。`aiproxyapi` サービスに設定があること、および `aiproxyapi` サービスの MongoDB と Redis のパスワードが `mongodb` サービスと `redis` サービスのパスワードと一致していることを確認してください。その後、`docker compose logs aiproxyapi` で API のログを確認します。

## OpenLM Platform への接続が失敗するのはなぜですか。

**Receivers Configuration** で、その接続の **Check Connection** を選択します。ステータスが **Failed** の場合は、次の点を確認してください。

- **Location** が、OpenLM Platform のベースアドレス (例: `https://example.com`) になっている。
- ホストがポート 443 で OpenLM Platform に到達できる。
- OpenLM Platform が保護されている場合は、**Client ID** と **Client Secret** が入力されていて、正しい。[OpenLM Platform に接続する](https://www.openlm.com/documentation/ja/cloud/deployment-operations/ai-proxy/configuration#openlm-platform-への接続)を参照してください。

## Broker Hub にエージェントが表示されないのはなぜですか。

エージェントは、接続を保存した後に表示されます。接続のステータスが **Ok** であることを確認し、[Broker Hub](https://www.openlm.com/documentation/ja/cloud/data-collection/broker-hub/) の **AI Proxy** タブを更新してください。データボリュームを削除した場合、スタックは新しいエージェントとして表示されます。Broker Hub で古いエージェントを削除してください。

## AI FinOps にデータが表示されないのはなぜですか。

AI Proxy は 5 分ごとに利用状況を OpenLM Platform に送信するため、リクエストの後、次の実行より前にデータが表示されることはありません。次の点を順に確認してください。

1. エージェントが Broker Hub にあり、接続のステータスが **Ok** である。
2. クライアントが、プロバイダーではなく AI Proxy にリクエストを送信している。[AI Proxy を設定する](https://www.openlm.com/documentation/ja/cloud/deployment-operations/ai-proxy/configuration)を参照してください。
3. **LLM Configuration** のプロバイダーが有効で、そのモードがクライアントの認証方法と一致している。

## クライアントが AI Proxy からエラーを受け取るのはなぜですか。

クライアントが拒否される場合は、まずキーを確認してください。マネージドモードでは、クライアントはプロバイダーのキーではなく、**Api Keys Configuration** で AI Proxy が発行する API キーを使用します。パススルーモードでは、クライアントが自身のプロバイダーキーを送信します。キーが正しい場合は、クライアントのエンドポイントを [AI Proxy を設定する](https://www.openlm.com/documentation/ja/cloud/deployment-operations/ai-proxy/configuration)と照らして確認してください。

:::note[次のステップ]
問題が解決しない場合は、[カスタマーポータル](https://customer.openlm.com)からチケットを作成し、`docker compose ps` と `docker compose logs` の出力を添付してください。
:::