コネクタのトラブルシューティング
トラブルシューティング情報を使用して、コネクタ・ハブの操作中にエラーが発生しました。
データが移動されない
コネクタを使用したデータの移動に関する問題のトラブルシューティング
コネクタはデータを移動していません。コネクタの例は、Connector Hubのシナリオを参照してください。
原因: データが存在しません
ソースには、コネクタのソース構成の問合せに一致するデータが含まれていません。
データがソースに存在するかどうかを確認するには、次のいずれかを実行します。
- コネクタのサービス・ログを取得します。(必要に応じて、最初にログを有効化します。)次に、コネクタが正常に実行されたことを示すログ・メッセージの例を示します(移動されたデータの量を含む)。
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: 認可の取得
受け入れたデフォルト・ポリシーがホーム・リージョンではないリージョンに伝播するには数分かかる場合があります。ポリシーが伝播されるまで、コネクタはデータを移動しません。
不明な理由の無効化
非アクティブ化されたコネクタをトラブルシューティングします。
コネクタのステータスはDeactivated
で、非アクティブ化しませんでした。
他のユーザーがコネクタを非アクティブ化しました
コネクタは他のユーザーによって非アクティブ化されました:
- 組織内の別のユーザー
- Oracle Cloud Infrastructure
特定の障害状態では、継続的に障害が発生するコネクタは、Oracle Cloud Infrastructureのサービス・チームによって自動的に非アクティブ化されます。このような長期連続障害は、コネクタのソースまたはターゲットの無効な構成を示す場合があります。
コネクタの再アクティブ化
- コネクタを更新して、ソースおよびターゲットの有効な構成を確認します。
- (オプション)コネクタのソースからターゲットへのデータ・フローの詳細を取得するには、コネクタのログを有効化します。
- コネクタを再アクティブ化します。
- ターゲット・サービスで予想される結果をチェックして、コネクタがデータを正常に移動することを確認します。
お知らせ: コネクタが非アクティブ化されました
コンソールのお知らせに「コネクタが非アクティブ化されました」と表示されます。
原因: 特定の障害状況では、継続的に障害が発生するコネクタは、Oracle Cloud Infrastructureのサービス・チームによって自動的に非アクティブ化されます。このような長期連続障害は、コネクタのソースまたはターゲットの無効な構成を示す場合があります。
コネクタの再アクティブ化
- コネクタを更新して、ソースおよびターゲットの有効な構成を確認します。
- (オプション)コネクタのソースからターゲットへのデータ・フローの詳細を取得するには、コネクタのログを有効化します。
- コネクタを再アクティブ化します。
- ターゲット・サービスで予想される結果をチェックして、コネクタがデータを正常に移動することを確認します。
お知らせ: コネクタの非アクティブ化を防ぐために必要なアクション
コンソールのお知らせに「コネクタの非アクティブ化を防ぐために必要なアクション」と記載されています。
原因: コネクタに一貫して障害が発生しています。
基本モードでの問合せの表示不可
コンソールで基本モードで問合せを表示する際の問題をトラブルシューティングします。
拡張モードで問合せを編集した後は、コンソールで基本モードを選択できません。
原因: 問合せが複雑すぎます
問合せに、基本モードでサポートされていない次の項目の1つ以上が含まれています。
OR
演算子(監査ログのみ使用時のタイプベース・フィルタを除く)- 関数(例:
isNull()
) select
summarize
処置: 問合せの更新
基本モードでサポートされる要素のみが含まれるように問合せを更新します:
問題がいつ発生したかを知る方法
コネクタで問題が発生するタイミングを特定します。
コネクタに関する問題の次のインジケータを確認します。
- 単一コネクタのデータ鮮度:データ移動の間に予期せぬ間隔が空いていることを確認します。
- ナビゲーション・メニューを開き、「アナリティクスとAI」をクリックします。「メッセージング」で、「コネクタ・ハブ」をクリックします。
- 「コンパートメント」を選択します。
- 必要なコネクタの名前をクリックします。
- 「リソース」で、「メトリック」をクリックします。
- 「データの最新性」メトリック・チャートを確認します。
- コネクタ間のデータの鮮度:データ移動の間に予期せぬ間隔が空いていることを確認します。
- ナビゲーション・メニューを開き、「監視および管理」をクリックします。「モニタリング」で、「サービス・メトリック」をクリックします。
- データの鮮度を表示しようとするコネクタを含むコンパートメントを選択します。
-
「メトリック・ネームスペース」で、oci_service_connector_hubを選択します。
- 次のメトリック・チャートを確認します:
- データの鮮度
-
ロギング・ソース: コネクタがログからデータを取得する場合、コネクタ当たりの最大時間取得量(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分以上に設定することをお薦めします。この構成では、指定された期間に複数の連続する障害が発生した場合にのみ、アラームが警告します。
- 値