Netskope Logsコネクタのトラブルシューティング
備考
ベータ版
この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。
このページでは、マネージド Netskopeログ コネクタで発生する可能性のある一般的なエラーとその解決方法について説明します。
Netskope APIトークンは無効です
エラーメッセージ：
Invalid Netskope API token. Verify that the API token has not expired. If it has expired, create a new API token, re-edit the UC connection, and run the pipeline again.
原因: APIトークンが見つからない、正しくない、または期限切れです。
ソリューション:
- Unity Catalog接続の**APIトークン**が現在のNetskope REST API v2トークンと一致していることを確認してください。
- トークンの有効期限が切れた場合は、新しいトークンを作成し、新しい値で接続を更新して、もう一度パイプラインを実行します。
詳細については、Netskopeへの認証を構成するを参照してください。
Netskope APIトークンの権限が不足しています
エラーメッセージ：
Insufficient Netskope API token privileges. Go to Settings > Administration > Administrators & Roles and provide the required View access to the role associated with the UC connection, then rerun the pipeline.
原因：トークンのロールに、取り込みたいイベントとアラートに対するビューアクセスが不足しています。
ソリューション:
- Netskopeで、 設定 > 管理 > 管理者とロール に移動します。
- 取り込みたいイベントとアラートに、Unity Catalog接続に関連付けられたロールの表示アクセスを付与します。
- パイプラインを再実行してください。
詳細については、Netskopeへの認証を構成するを参照してください。
Netskope API レート制限を超過
エラーメッセージ：
Netskope API rate limit exceeded; will back off and retry.
原因： NetskopeがHTTP 429応答を返しました。Netskopeは、REST API v2エンドポイントにレート制限を適用しています。REST API v2データエクスポートイテレータエンドポイントの使用を参照してください。
ソリューション:
コネクタは自動的に一時停止し、再試行します。これが繰り返し発生する場合は、パイプラインのスケジュール頻度、または同じ Netskope API トークンを共有している並列パイプラインの数を削減してください。
Netskope APIは一時的に利用できません
エラーメッセージ：
Netskope API temporarily unavailable, please try the pipeline again.
原因： Netskope は一時的なサーバーエラー (HTTP 500、502、503、または 504) を返しました。
ソリューション:
コネクタは自動的に再試行します。問題が解決しない場合は、待機してから、もう一度パイプラインを実行してください。