コネクタのトラブルシューティング
トラブルシューティング情報を使用して、コネクタ・ハブの操作中にエラーが発生しました。
コネクタ・ハブの既知の問題も参照してください。
データが移動されない
コネクタを使用したデータの移動に関する問題のトラブルシューティング
コネクタはデータを移動しません。コネクタの例は、コネクタ・ハブのシナリオを参照してください。
原因: データが存在しません
ソースには、コネクタのソース構成の問合せに一致するデータが含まれていません。
データがソースに存在するかどうかを確認するには、次のいずれかを実行します。
- このコネクタのサービス・ログを取得します。(必要に応じて、最初にログを有効化します。)次に、コネクタが正常に実行されたことを示すログ・メッセージの例を示します(移動されるデータの量を含む)。
Service connector run succeeded - <number> messages (<number> bytes) written to target
- ソース・ログの場合は、コネクタのソース構成からの問合せを使用してログを検索します。
- ソース・メトリックの場合は、メトリックを問い合せる。
- ソース・ストリームの場合は、ストリームのデフォルト・プロデューサ・メトリックを問い合せます。
修正: コネクタの更新
原因: サービス・レベルのエラー
ソース・サービス、ターゲット・サービスまたはコネクタ・ハブ・サービスのエラーにより、データの移動が妨げられています。
サービス・レベルのエラーが存在するかどうかを確認するには、次のいずれかを実行します。
- このコネクタのサービス・ログを取得します。(必要に応じて、最初にログを有効化します。)次に、サービスレベルのエラーを示すログメッセージの例を示します。
Connector run failed due to <type> error, Error Code : XXX <exception>
- コネクタの次のメトリック・チャートを表示します:
- ソースでのエラー
- ターゲットでのエラー
- コネクタ・ハブのエラー
修正: コネクタの更新
処置: サポートに連絡
5xx
または-1
が表示された場合は、サポートに連絡してください。ヘルプの利用とサポートへの連絡を参照してください。原因: 承認がありません
ターゲット・サービスへの書込み権限がありません。
認可がないかどうかを確認するには、コネクタのサービス・ログを取得します。(必要に応じて、最初にログを有効化します。)次に、欠落している認可を示すログ・メッセージの例を示します。
Connector run failed due to <type> error, Error Code : 404 NotAuthorizedOrNotFound
Remedy: 認可の取得
受け入れたデフォルト・ポリシーがホーム・リージョンではないリージョンに伝播するには数分かかる場合があります。ポリシーが伝播されるまで、コネクタはデータを移動しません。
原因: ペイロードが機能構成と一致しません
ファンクション・タスクによって返されるペイロードが、ファンクション・タスクで使用されるファンクションの構成済ヘッダーと一致しません。たとえば、無効なJSONを含むペイロードは、次のヘッダー構成を持つファンクションによって返されます。
headers={"Content-Type": "application/json"}
この問題は、エラー・メッセージExpected JSON response from function, but received a different type
で示されます。
Remedy: 機能を再構成します。
不明な理由の無効化
非アクティブ化されたコネクタをトラブルシューティングします。
コネクタのステータスはDeactivated
で、非アクティブ化しませんでした。
他のユーザーがコネクタを非アクティブ化しました
コネクタは他のユーザーによって非アクティブ化されました:
- 組織内の別のユーザー
-
Oracle Cloud Infrastructure
特定の障害状態では、継続的に障害が発生するコネクタは、Oracle Cloud Infrastructureのサービス・チームによって自動的に非アクティブ化されます。このような長期連続障害は、コネクタのソースまたはターゲットの無効な構成を示す場合があります。
コネクタの再アクティブ化
- コネクタを更新して、ソースとターゲットの有効な構成を確認します。
- (オプション)コネクタのソースからターゲットへのデータ・フローの詳細を取得するには、コネクタのログを有効化します。
- コネクタを再アクティブ化します。
- ターゲット・サービスで予想される結果を確認して、コネクタがデータを正常に移動することを確認します。
お知らせ: コネクタが非アクティブ化されました
コンソールのお知らせに「コネクタが非アクティブ化されました」と表示されます。
原因: 特定の障害状況では、継続的に障害が発生するコネクタは、Oracle Cloud Infrastructureのサービス・チームによって自動的に非アクティブ化されます。このような長期連続障害は、コネクタのソースまたはターゲットの無効な構成を示す場合があります。
コネクタの再アクティブ化
- コネクタを更新して、ソースとターゲットの有効な構成を確認します。
- (オプション)コネクタのソースからターゲットへのデータ・フローの詳細を取得するには、コネクタのログを有効化します。
- コネクタを再アクティブ化します。
- ターゲット・サービスで予想される結果を確認して、コネクタがデータを正常に移動することを確認します。
お知らせ: コネクタの非アクティブ化を防ぐために必要なアクション
コンソールのお知らせに「コネクタの非アクティブ化を防ぐために必要なアクション」と記載されています。
原因: コネクタに一貫して障害が発生しています。
基本モードでの問合せの表示不可
コンソールで基本モードで問合せを表示する際の問題をトラブルシューティングします。
拡張モードで問合せを編集した後は、コンソールで基本モードを選択できません。
原因: 問合せが複雑すぎます
問合せに、基本モードでサポートされていない次の項目の1つ以上が含まれています。
-
OR
演算子(監査ログのみ使用時のタイプベース・フィルタを除く) - 関数(例:
isNull()
) -
select
-
summarize
処置: 問合せの更新
基本モードでサポートされる要素のみが含まれるように問合せを更新します:
エラー: ファンクションからのJSONレスポンスが必要ですが、別のタイプを受け取りました
このエラー・メッセージは、コネクタの実行中に発生します。
原因: ペイロードが機能構成と一致しません
ファンクション・タスクによって返されるペイロードが、ファンクション・タスクで使用されるファンクションの構成済ヘッダーと一致しません。たとえば、無効なJSONを含むペイロードは、次のヘッダー構成を持つファンクションによって返されます。
headers={"Content-Type": "application/json"}
この問題は、エラー・メッセージExpected JSON response from function, but received a different type
で示されます。
Remedy: 機能を再構成します。
問題がいつ発生したかを知る方法
コネクタで問題が発生するタイミングを特定します。
コネクタに関する問題の次のインジケータを確認します。
-
単一コネクタのデータ鮮度:データ移動の間に予期せぬ間隔が空いていることを確認します。
- ナビゲーション・メニューを開き、「アナリティクスとAI」を選択します。「メッセージング」で、「コネクタ・ハブ」を選択します。
- 「コンパートメント」を選択します。
- 目的のコネクタの名前を選択します。
- 「リソース」で、「メトリック」を選択します。
- 「データの最新性」メトリック・チャートを確認します。
-
コネクタ間のデータの鮮度:データ移動の間に予期せぬ間隔が空いていることを確認します。
- ナビゲーション・メニューを開き、「監視および管理」を選択します。「モニタリング」で、「サービス・メトリック」を選択します。
- データの鮮度を表示しようとするコネクタを含むコンパートメントを選択します。
-
「メトリック・ネームスペース」で、oci_service_connector_hubを選択します。
- 次のメトリック・チャートを確認します:
- データの鮮度
-
ロギング・ソース: コネクタがログからデータを取得する場合、コネクタごとに1時間当たりの最大データ取得量(1 GB)を超えて試行している可能性があります。ターゲットのログ・データが配信されるのは、この問題が過去24時間(コネクタによる以前の送信の欠落データを捕捉するための最大期間)にわたって継続している場合ではありません。この問題が発生しているかどうかを判断するには、アラームを作成して次のインジケータをモニターします。
インジケータ(メトリック) MQLのアラーム問合せ(コメントあり) 12時間よりも古いデータ(データの最新性) DataFreshness[1h].mean() > 43200000
コメント:
- 値
43200000
は、12時間のミリ秒数です。 - ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
ソースでのエラー(すべてのエラー)(ソースでのエラー) ErrorsAtSource[15m].groupby(errorCode,connectorId).min() > 0
コメント:
- ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
- 結果は、エラー コードとコネクタ別にグループ化されます。
ソースでの内部エラーで15分後に解決していない(5xx)(ソースでのエラー) ErrorsAtSource[15m]{errorCode =~ "5*"}.groupby(connectorId).sum() > 0 && ErrorsAtSource[15m].groupby(connectorId).min() > 0
コメント:
- 内部エラーはソースでの問題を示している場合があり、このためにデータの配信が遅延することがあります。
- アラームをトリガーする間隔を短縮するには、間隔([15m])を変更します。
- ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
ソースでのスロットル・エラー(ソースでのエラー) ErrorsAtSource[15m]{errorCode = "429"}.groupby(connectorId).sum() >0 && ErrorsAtSource[15m].groupby(connectorId).min() > 0
コメント:
- スロットル・エラーの詳細は、関連するサービスの制限の説明を参照してください。
- たとえば、ストリーミング・ソースに関連するスロットル・エラーは、ストリーミング・リソースの制限を参照してください。ストリーミング・ソースでのスロットルは、コネクタがパーティションからストリームを読み取ろうとしたときに、同じパーティションへの他のコールも発生して、コール数がサービスの制限を超える場合に発生します。
- ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
ソースでのサービス通信エラー(-1)(ソースでのエラー) ErrorsAtSource[15m]{errorCode = "-1"}.groupby(connectorId).sum() >0 && ErrorsAtSource[15m].groupby(connectorId).min() > 0
ソースでの404エラー(ソースでのエラー) ErrorsAtSource[15m]{errorCode = "404"}.groupby(connectorId).sum() >0
コメント:
- コネクタがログにアクセスできないか、存在しません。
- 指定されたログにアクセスするためのポリシーが存在することを確認します。認証と認可を参照してください。
- ロギング でログを検索して、指定されたログが存在することを確認します。
- ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
ゼロ(0)バイトの読取り(データがあるはずの場合) (ソースからの読取りバイト数) BytesReadFromSource[15m].groupby(connectorId).sum() == 0
コメント:
- ソース、ターゲットまたはタスクでエラーが発生していない場合、ログが存在しない可能性があります。ロギング でログを検索して、指定されたログが存在することを確認します。
- ときどき失敗を無視します。アラーム・トリガー遅延を30分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
- 値