トラブルシューティング

1. ドメイン・エンドポイント、インスタンスの外部キーおよび構成済authIdを確認します。同じOCIDでバージョン更新を、別のリソースOCIDで置換と区別します。
2. シークレットの場合、目的のバージョンがCURRENTであること、デバイスがBase64表現ではなく元の値を使用すること、およびIoTドメインがシークレットを読み取ることができることを確認します。シークレット・ローテーションのトラブルシューティングを参照してください。NotAuthorizedOrNotFoundエラーについては、シークレット・アクセスおよびポリシーも確認してください。
3. 証明書の場合は、構成済のリソース・タイプ、発行者のバージョン、有効性、失効ステータス、証明書チェーン、共通名および一致する秘密キーを確認します。ルートCAはauthIdにできません。Troubleshooting Certificate Rotationを参照してください。
4. 新規接続に置換資格証明を使用し、テスト・メッセージを送信して、目的のインスタンスの取込みを確認します。認証は成功したが、取込みが失敗した場合は、資格証明の失敗として処理するのではなく、メッセージ・トピックまたはHTTPSエンドポイント、ペイロードおよび適用可能なアダプタを確認します。
5. 古い資格証明のみが失敗した場合は、サポートされている重複に対して資格があるかどうかを確認します。バージョンが Vaultまたは証明書に存在するため、受け入れられたままであると想定しないでください。資格証明のローテーション、削除、またはTLS検証の無効化を繰り返し実行して調査しないでください。

リージョン、ドメインおよびデジタル・ツイン・インスタンスのOCIDs、認証リソースのOCIDとタイプ、バージョン番号とステージ、タイムゾーン、プロトコル、エラー・コードおよびリクエストID (使用可能な場合)による変更および失敗のタイムスタンプを記録します。障害が置換資格証明、前の資格証明、またはその両方に影響するかどうか、および新しい接続がデータを認証して取り込むかどうかを記録します。

承認されたサポート・チャネルを通じてこの証拠を提供します。資格証明を含むパスワード、シークレット・コンテンツ、秘密キー、認可ヘッダーまたはリダクションされていないコマンド出力は含めないでください。妥協の疑いがある場合は、ローテーションの重複に依存するのではなく、組織のインシデント対応プロセスに従ってください。

1. 「IoTドメイン・データベース・スキーマ」でフィルタ列のデータ型を確認します。TIME_RECEIVEDを使用してRAWデータを受信時間でフィルタし、TIME_OBSERVEDを使用して履歴サンプルを観察時間でフィルタします。
2. 必要な列を選択し、開始を含む終了排他的な時間範囲を指定します。たとえば、この問合せでは、CONTENTペイロードを取得せずにRAWメッセージ・メタデータを取得します。スキーマ・プレースホルダをIoTドメインの短縮IDに置き換え、SQLクライアントのバインド変数メカニズムを使用して、:start_timeおよび:end_timeを文字列(2026-09-20 10:00:00.000000や2026-09-20 11:00:00.000000など)としてバインドします。

   SELECT id,
          digital_twin_instance_id,
          endpoint,
          content_type,
          time_received
   FROM <domain-short-id-from-device-host>__IOT.RAW_DATA
   WHERE time_received >= TO_TIMESTAMP(
           :start_time, 'YYYY-MM-DD HH24:MI:SS.FF6')
     AND time_received < TO_TIMESTAMP(
           :end_time, 'YYYY-MM-DD HH24:MI:SS.FF6');

   時間制限により、検索されるデータが制限され、列ではなく入力を変換すると、タイムスタンプ索引を効率的に使用できる機会が保持されます。メタデータを選択すると、不要なペイロードのフェッチが回避されます。基礎となるデータ・ブロックが読み取られないことは保証されません。

3. テキスト入力の場合は、TO_TIMESTAMP書式マスクを指定された文字列と照合します。この例では、データと同じ時間規則で、タイムゾーンオフセットのない値を受け入れます。両方の値が移入され、開始が終了より前になっていることを確認します。入力がすでにTIMESTAMPとして入力されている場合は、テキスト変換を通過するのではなく、直接比較します。これらの述語では、書式設定または変換関数をTIME_RECEIVEDまたはTIME_OBSERVEDに適用しないでください。
4. APEX日時ページ・アイテムの入力については、明示的な変換例については、「APEXページ・アイテムからの型付き値の使用」を参照してください。テキスト変換の詳細は、TO_TIMESTAMPを参照してください。
5. 問合せの速度が遅い場合は、問合せ、入力タイプと値、リクエストされた時間範囲、経過時間およびエラー・メッセージを取得して、さらに調査します。これらの問合せパターンでは、特定のレスポンス時間が保証されません。

1. データベース・ユーザーのパスワードを変更できるのは、APEXワークスペース管理者のみです。最初は、APEXワークスペース管理者がAPEXデータベース・パスワードを使用してログインしてから、次のステップに従ってデータベース・パスワードを変更します。

   APEXで、ワークスペース名およびデータベース・ユーザー名として、現在のAPEXデータベース・パスワードを使用して、IoTドメインのワークスペースに管理者としてログインします。
   ノート
   
   2つのアンダースコア__WKSPに注意してください。

   <domain-short-id-from-device-host>__WKSP

2. 「SQLワークショップ」に移動し、「SQLコマンド」を選択します。
3. 右上のスキーマ・ドロップダウン・メニューから<iot-domain-short-id-from-device-host>__WKSPスキーマが選択されていることを確認します。スキーマに2つのアンダースコアが含まれていることに注意してください。
4. データベース・ユーザーのパスワードを変更するには、次のSQLALTER USER文および必要なREPLACE句を使用します。

   ALTER USER <workspace-administrator-user-name> IDENTIFIED BY "<new-password>" REPLACE "<old-password>";

5. 「実行」を選択します。
6. パスワード更新の結果の例:

   User altered.
   
   0.24 seconds

• APEXワークスペース管理者は、ワークスペース管理パスワードを変更できます。管理者としてAPEXにログインした後、「APEXアカウント・パスワードの設定」オプションを選択します。詳細は、APEXでのパスワードのリセットを参照してください。
• APEXユーザーとして、APEXアプリケーションに初めてログインすると、APEXパスワードの変更を求められます。最初のログイン後、APEXログイン・ページでパスワードをリセットできます。

1. ナビゲーション・メニューを開き、「アイデンティティと管理」に移動して「ドメイン」を選択します。
2. ドメイン・リスト・ページで、操作するアイデンティティ・ドメインを選択し、IoTドメインに接続します。
3. 「ユーザー管理」タブを選択し、パスワードを更新するユーザーを選択します。「データベース・パスワード」タブを選択して、パスワードを更新し、現在のIAMデータベース・パスワードを削除して新しいIAMデータベース・パスワードを作成します。

IoTリソースの制限を確認するには、サービス制限を参照してください。制限を増やす必要がある場合は、サービス制限の引上げをリクエストできます。

--external-key 01-23-45-67-89-ab

ベスト・プラクティス: 外部キーを使用してデジタル・ツイン・インスタンスを作成し、american-autoなどの引用符を含めません。または、引用符で囲まれたユーザー名で認証する必要がある場合は、-uを使用せずにAuthorization: Basic ...ヘッダーを構築して、引用符のエラーを回避します。

"$.speed": "${(.velocity_kph / 1.609) | floor}"

1. アクティブ化操作によって作成された作業リクエストをオープンし、そのエラーをレビューします。
2. IAMポリシーで、フロー・ランタイムを更新し、参照されるIoTドメイン、サブネット、ネットワーク・セキュリティ・グループ、ログ、マウント・ターゲットおよびエクスポートを読み取ることができることを確認します。
3. 参照されるすべてのリソースが、必要なコンパートメントおよびリージョンに存在することを確認します。
4. 報告された構成の問題を修正し、ランタイムを再度アクティブ化して、作業リクエストが完了するまで待機します。

1. フロー・ランタイムのライフサイクル状態が「アクティブ」であることを確認します。
2. IAMポリシーで、IoTドメインおよびフロー・ランタイムへのアクセスが許可されていることを確認します。
3. 「フロー・ランタイム」詳細ページをリフレッシュし、「オープン・フロー・ランタイム・エディタ」を再度選択します。
4. 「デプロイ」を選択する前に、ノード-REDフローを検証します。エディタによって報告されたノード構成エラーを修正します。
5. エディタで「デプロイ」が失敗した場合は、構成済のログを確認し、現在のフロー・ドキュメントを取得して、使用するフローと比較します。
6. CLIまたはAPIの更新に失敗した場合は、入力が完全なJSONフロー・ドキュメントであることを確認します。CLIの場合は、--flows-documentパラメータを使用し、ファイル・パスの前にfile://を付けます。IoTフロー・ランタイムのフローの更新を参照してください。更新操作は同期しており、作業リクエストは作成されません。

1. ランタイムのネットワーク構成を確認し、目的のサブネットおよびネットワーク・セキュリティ・グループが使用されていることを確認します。
2. サブネット・ルート表にエンドポイントへのルートがあることを確認します。プライベート・サブネットからのアウトバウンド・インターネット・アクセスの場合は、NATゲートウェイおよびルーティング構成を確認します。
3. セキュリティ・リストおよびネットワーク・セキュリティ・グループで、必要なアウトバウンド・プロトコルおよびポートと必要なリターン・トラフィックが許可されていることを確認します。
4. ノード-REDノードのエンドポイント・ホスト名、ポート、TLS構成および認証値を確認します。
5. MQTTの場合、各フロー・ランタイムで一意のクライアントIDが使用されていることを確認します。共有サブスクリプションを使用する場合は、各ランタイムで同じ共有サブスクリプション・トピックを使用し、各ランタイムで異なるクライアントIDを使用します。
6. 修正されたフローの「デプロイ」を選択し、構成されたログおよびフロー・ランタイム・メトリックを確認します。

1. ランタイムのファイル・ストレージ・マウント構成を確認します。
2. マウント・ターゲットおよびエクスポートOCIDsが正しいことを確認します。構成されたマウント・パスは、先頭または末尾のスラッシュ・セグメントやパス・トラバース・セグメントを含まない相対パスである必要があります。たとえば、historyは/mnt/historyのフロー・ランタイムで使用できます。
3. ファイル・ストレージ・エクスポートの「ポート」オプションが「特権」に設定されていることを確認します。
4. マウント・ターゲットのNSGで、必要なファイル・ストレージ・トラフィックが許可されていることを確認します。マウント・ターゲットでNSGを使用しない場合は、そのサブネット・セキュリティ・リストに、TCPおよびUDPポート111およびポート2048-2051のフロー・ランタイム・サブネットCIDRからのステートフル・イングレス・ルールがあることを確認します。
5. ランタイムを更新する場合は、サブネット、ネットワーク・セキュリティ・グループ、およびアタッチされたままにしておく必要があるすべてのFile Storageマウントを含む、完全な置換ネットワーク構成を指定します。
6. 更新作業リクエストが完了するまで待機し、マウントされたパスでファイルが表示され、読取り可能であることを確認してから、フローを再度実行します。

1. フロー・ランタイムがアクティブであり、ノード-REDエディタが正常なデプロイメントをレポートしていることを確認します。
2. ソースが、入力ノードで構成されたホスト、ポートおよびトピックにメッセージを送信していることを確認します。
3. ノード-REDデバッグ・ノードおよび構成済ランタイム・ログを使用して、各変換の前後にメッセージを検査します。
4. 出力ノードで、デジタル・ツイン・アダプタで想定される正しいIoTデバイス・ホスト、デバイス資格証明およびトピックが使用されていることを確認します。
5. RAWデータが到着したが正規化データがない場合は、アダプタ・ルート条件、ターゲット・マッピング、ペイロード・マッピングおよびデジタル・ツイン・インスタンスの関連付けを確認します。
6. 処理または配信の失敗について、ターゲット・デジタル・ツイン・インスタンスのデータおよびフロー・ランタイム・メトリックを確認します。

1. フローに一致するキューを選択します。監視シナリオでは、<domain-short-id>__IOT.NORMALIZED_DATAを使用します。
2. NORMALIZED_DATAでは、JSONペイロードを選択し、ADTオブジェクト型を指定しません。正規化されたレコードには、digitalTwinInstanceId、contentPath、valueおよびtimeObservedが含まれます。
3. かわりにRAW入力を意図的に消費するフローの場合は、キュー<domain-short-id>__IOT.RAW_DATA_INおよびオブジェクト型<domain-short-id>__IOT.RAW_DATA_IN_TYPEを使用します。正規化されたキューでRAWオブジェクト・タイプを使用しないでください。
4. 外部認証を有効にし、プロキシ・ユーザーが<domain-short-id>_<flow-runtime-short-id>__FRであることを確認します。
5. モニタリング・フローの場合は、ドメインおよびフロー・ランタイムの短縮IDを使用して、「サブスクライバ」を<DOMAIN_SHORT_ID>_<FLOW_RUNTIME_SHORT_ID>_SUBSCRIBERに設定します。名前全体を大文字に変換し、各部分の間に1つのアンダースコアを使用します。たとえば、abcd1234およびefab5678はABCD1234_EFAB5678_SUBSCRIBERを生成します。これはサブスクライバ名であり、__FRデータベース・プロキシ・ユーザーではありません。「キュー・サブスクライバの識別」を参照してください。
6. フロー・ランタイム・スキーマの設定では、NORMALIZED_DATAにサブスクライバが登録されます。フローをインポートしたり、そのインジェクト・ノードをトリガーしても、サブスクライバは作成されません。IDおよび名前を確認した後にサブスクライバが欠落している場合は、ランタイム管理者に、このランタイムおよびキューの登録を確認するよう依頼してください。
7. 「デプロイ」を選択し、テストIoTイベントを公開し、デバッグ・ノードを一時的に接続して、実際のキュー・ペイロードおよびフィールド・ケースを検査します。

1. 参加するすべてのフロー・ランタイムを、$share/fr-guide/source/+/+などの同じ共有トピックで構成します。
2. すべてのランタイムに一意のMQTTクライアントIDを指定します。クライアントIDを再利用すると、あるアクティブなランタイムが別のランタイムを切断する可能性があります。
3. MQTT 5.0を使用して、ブローカが共有サブスクリプションをサポートしていることを確認します。
4. source/hvacs/fr-guide-hvac-01などの通常のトピックにパブリッシュします。$shareサブスクリプション・トピックに公開しないでください。
5. 共有グループ外の同じメッセージを意図的に処理する独立したsource/+/+サブスクリプションを削除します。

1. OCIノードの場合、フロー・ランタイム・コンパートメントとリソース・タイプが動的グループ・ルールと一致することを確認します。新規または移動されたランタイムが、目的のルールと一致しない場合があります。
2. OCIノードの場合、リソース・プリンシパル・ポリシー・サブジェクトが正しい動的グループおよびアイデンティティ・ドメインを使用していることを確認します。
3. OCIノードの場合、リソース・プリンシパル・ポリシーが、ターゲット・リソースまたは適切な親コンパートメントを含むコンパートメントに作成されていることを確認します。
4. 既存のログの場合、作成時のロギング・ポリシーでread log-groupsおよびuse log-contentが付与されていることを確認します。ログの自動作成用にログ・グループのみを選択した場合は、ポリシーによってmanage log-groupsおよびuse log-contentが付与されていることを確認します。ポリシーがログ・グループを含むコンパートメントに適用され、構成されたログ・グループおよびログOCIDsが正しいことを確認します。
5. OCIノードの場合は、失敗した操作を特定し、それをオブジェクト・ストレージ、通知またはIoTノードの最小権限の例と比較します。
6. ターゲットOCID、コンパートメント、バケット名、トピックまたはデータベースが、リソース・プリンシパル・ポリシーで指定されたリソースであることを確認します。
7. 動的グループまたはポリシーの変更後、IAMの変更が有効になるまで待機し、操作をデプロイまたは再試行して、フロー・ランタイム・ログを確認します。
8. ポリシーが文書化された要件と一致し、アクセスが拒否された場合は、Oracle Supportに連絡する前に、作業リクエスト・エラー、リクエストID、ランタイムOCID、ターゲット・リソースのOCIDおよびポリシー・ステートメントを収集してください。