翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 一般的な設定の問題のトラブルシューティング
<a name="mlflow-troubleshooting"></a>

一般的な問題のトラブルシューティングについて説明します。

## Could not find executable named 'groff'
<a name="mlflow-troubleshooting-groff"></a>

を使用する場合 AWS CLI、 というエラーが発生することがあります`Could not find executable named 'groff'`。

Mac を使用している場合は、次のコマンドを使用してこの問題を解決できます。

```
brew install groff
```

Linux マシンでは、次のコマンドを使用します。

```
sudo apt-get update -y
sudo apt-get install groff -y
```

## Command not found: jq
<a name="mlflow-troubleshooting-jq"></a>

AuthZ アクセス許可ポリシーの JSON ファイルを作成する際に、`jq: command not found` というエラーが発生することがあります。

Mac を使用している場合は、次のコマンドを使用してこの問題を解決できます。

```
brew install jq
```

Linux マシンでは、次のコマンドを使用します。

```
sudo apt-get update -y
sudo apt-get install jq -y
```

## AWS MLflow プラグインのインストール速度
<a name="mlflow-troubleshooting-speeds"></a>

Mac Python 環境を使用する場合、 AWS MLflow プラグインのインストールには数分かかることがあります。

## UnsupportedModelRegistryStoreURIException
<a name="mlflow-troubleshooting-uri-exception"></a>

`UnsupportedModelRegistryStoreURIException` が表示される場合は、次の手順で対処してください。

1. Jupyter notebook カーネルを再起動します。

1.  AWS MLflow プラグインを再インストールします。

   ```
   !pip install --force-reinstall sagemaker-mlflow
   ```

## サポートされていない MLflow 機能
<a name="mlflow-troubleshooting-unsupported-features"></a>

オープンソースの MLflow で使用できる一部の機能は、Amazon SageMaker AI マネージド MLflow ではサポートされていません。

現在、以下の機能はサポートされていません。
+ **[MLflow AI Gateway](https://mlflow.org/docs/latest/genai/governance/ai-gateway/)** – LLM プロバイダーへの接続を管理するための MLflow AI Gateway は使用できません。
+ **[LLM 審査員とスコアラー](https://mlflow.org/docs/latest/genai/eval-monitor/scorers/)** – 組み込み審査員とカスタム審査員はサポートされていません。コードベースのスコアラーは引き続き期待どおりに動作します。
+ **[プロンプトの最適化](https://mlflow.org/docs/latest/genai/prompt-registry/optimize-prompts/)** – 自動プロンプト最適化は使用できません。
+ **[OpenTelemetry Integration](https://mlflow.org/docs/latest/genai/tracing/opentelemetry/)** – OTEL 互換トレース取り込みエンドポイントは使用できません。

これらの機能を使用しようとすると、UI 要素の欠落や予期しないエラーが発生する可能性があります。これは、Amazon SageMaker AI マネージド環境で予想される動作です。