メインコンテンツまでスキップ

OpenLM AI Proxy のトラブルシューティング

次の質問から、該当する症状を探してください。導入の手順については、AI Proxy を導入するを参照してください。

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

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

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

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

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

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

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

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

docker compose down -v
docker compose up -d

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

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

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 に接続するを参照してください。

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

エージェントは、接続を保存した後に表示されます。接続のステータスが Ok であることを確認し、Broker Hub の AI Proxy タブを更新してください。データボリュームを削除した場合、スタックは新しいエージェントとして表示されます。Broker Hub で古いエージェントを削除してください。

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

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

  1. エージェントが Broker Hub にあり、接続のステータスが Ok である。
  2. クライアントが、プロバイダーではなく AI Proxy にリクエストを送信している。AI Proxy を設定するを参照してください。
  3. LLM Configuration のプロバイダーが有効で、そのモードがクライアントの認証方法と一致している。

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

クライアントが拒否される場合は、まずキーを確認してください。マネージドモードでは、クライアントはプロバイダーのキーではなく、Api Keys Configuration で AI Proxy が発行する API キーを使用します。パススルーモードでは、クライアントが自身のプロバイダーキーを送信します。キーが正しい場合は、クライアントのエンドポイントを AI Proxy を設定すると照らして確認してください。

次のステップ

問題が解決しない場合は、カスタマーポータルからチケットを作成し、docker compose ps と docker compose logs の出力を添付してください。

にMaria Gilcaが最終更新

ドキュメントチームは、大規模言語モデルを使ってこのページを下書きすることがあります。公開前に、テクニカルライターがすべてのページをレビューし、製品と照らし合わせて検証します。最終的な判断は人間が行います。