OCIインテグレーションで問題が発生している場合は、ここから開始してください。
トラブルシューティングログ OCIログが表示されない、予期せず停止する、重複して表示される、またはリソース名が正しく表示されない場合は、以下のヘルスチェックから開始し、続くセクションで特定の問題を確認してください。
健康診断 これらの2つのチェックにより、問題がOCIのアップストリームにある(New Relicで確認すべきことはまだない)か、ログが実際にNew Relicに到達しているかがわかります:
OCIのコネクタを確認してください。 OCIコンソールでConnector Hub に移動し、New Relicインテグレーションをデプロイしたコンパートメントを開きます。newrelic-logs-<region>-auditという名前のコネクタ(たとえば、newrelic-logs-us-ashburn-1-audit)を探し、そのステータスがActive であることを確認します。エラーステータスが表示されている場合は、コネクタを開いてエラーの詳細を確認してください。
ログがNew Relicに届いていることを確認してください。 データのクエリ でこのクエリを実行します:
SELECT count ( * ) FROM Log WHERE oracle . loggroupid = '_Audit' SINCE 30 minutes ago
カウントがゼロより大きい場合は、監査ログが送信されていることを意味します。別のログタイプのトラブルシューティングを行っている場合は、代わりに該当する時間枠の最近の結果が表示されることを確認してください。
両方のチェックが正常である場合、問題は完全な停止ではなく、以下の特定のシナリオのいずれかである可能性があります。
ログがまったく表示されない 発生している事象を考えられる原因と照らし合わせてください:
これが表示された場合
こちらをお試しください
セットアップを完了したばかりで、まだ何も表示されていません
しばらくお待ちください。初めてコネクタを作成する際、OCIが最近のアクティビティをバックフィルするのに時間がかかる場合があります — 監査ログの場合、過去のイベントについては最大24時間かかることがありますが、通常、新しいイベントは数分以内に表示されます。
Connector Hub にコネクタがまったく表示されない
設定を再度開きます:ガイド付き設定ウィザードを使用した場合は、関連するトグルをオンにしたことを確認し、再実行してください。Terraformを使用した場合は、設定にログコネクタが含まれていることを確認し、再適用してください。
複数のOCIリージョンにリソースがある
各リージョンに独自のコネクタがあること、想定しているリージョンを確認していることを確認し、追加のリージョンがある場合は設定を繰り返してください。
コンパートメントまたはロググループを読み込む際に、New Relic UIにアクセス/権限エラーが表示される
以下の権限の不足 を参照してください。
正常に機能した後にログが停止した 発生している事象を考えられる原因と照らし合わせてください:
これが表示された場合
こちらをお試しください
OCIのコネクタがなくなりました Active
Connector Hub でコネクタを開き、そのエラーの詳細を確認してください。通常、これは権限の変更が原因であるか(権限の不足 を参照)、誰かが基盤となるインテグレーションを再デプロイまたは置き換えたことが原因です。
コネクタはActive ですが、新しいログが表示されません
OCIコンソールでFunctions に移動し、New Relicインテグレーション関数がデプロイされており、エラー状態を示していないことを確認します。ログフォワーダーのオブザーバビリティ をセットアップしている場合は、シークレット取得エラーや配信エラーなどの特定の障害について、まずそのダッシュボードを確認してください。依然として異常な状態が続いており、OCIだけで解決できない場合は、サポートにお問い合わせください。
最近、誰かが設定を変更しました(ウィザードの再実行、Terraform設定の変更、トグルのオフ)。
コネクターを復元するには、正しいオプションを有効にしてセットアップを再実行してください — その変更によって削除または変更された可能性があります。
重複するログエントリ 複数のコネクタが同じログイベントをNew Relicに送信しています。これは通常、OCI内の複数のコネクタが同じログをカバーしていることを意味します — 多くの場合、単一のコンパートメントのみをカバーしていた古いコネクタを削除せずに、より広範な「すべてのコンパートメント」コネクタが追加されたことが原因です。
Connector Hub で、New Relicインテグレーションに関連するすべてのコネクタをリストし、それぞれがカバーする範囲を確認してください。重複するものを削除し、実際に必要な範囲をカバーするコネクタを1つだけ残してください。
コンパートメントまたはリソースが見つからない コネクタのスコープが、想定していたすべての範囲をカバーしていません。
セットアップの対象範囲
含まれるもの
テナンシ全体(将来のものを含むすべてのコンパートメント)
すべて自動的に — 新しいコンパートメントを追加する際、アクションは必要ありません。
特定のコンパートメントおよびその配下のすべて
そのコンパートメントおよびそのサブコンパートメント(後から追加された新しいサブコンパートメントを含みます)。
特定の1つのコンパートメントのみ
そのコンパートメントのみ — 新しいサブコンパートメントは自動的に含まれません。
ガイド付きウィザードを使用してセットアップした場合、コネクタはすでにテナンシ全体をカバーしています — コンパートメントがまだ欠落している場合、これはスコープの問題ではなく、コネクタの問題を示しています(ログがまったく表示されない を参照してください)。手動またはTerraform経由でセットアップした場合は、コネクタに設定したスコープを確認し、必要に応じてより広いスコープで再作成してください。
アクセス権限の欠如 New Relicに必要なOCI権限がありません — これにより、コネクタの作成が完全にブロックされたり、完全な機能なしで実行されたりする可能性があります。
セットアップ中に作成された動的グループに対して、以下のポリシーステートメントが存在することをOCIテナンシのアドミニストレーターに確認するよう依頼してください:
ポリシー
用途
Allow dynamic-group your_dynamic_group_name to read log-content in tenancy
ログデータの読み取り
Allow dynamic-group your_dynamic_group_name to use fn-function in tenancy
New Relicインテグレーションの実行
Allow dynamic-group your_dynamic_group_name to use fn-invocation in tenancy
New Relicインテグレーションの実行
Allow dynamic-group your_dynamic_group_name to read secret-bundles in tenancy where any { target.secret.id = 'your_ingest_secret_ocid', target.secret.id = 'your_user_secret_ocid' }
New Relicライセンスキーへの安全なアクセス
Allow dynamic-group your_dynamic_group_name to inspect dns-family in tenancy
DNSリソースのフレンドリ名の解決
Allow dynamic-group your_dynamic_group_name to inspect goldengate-family in tenancy
GoldenGateリソースのフレンドリ名の解決
Allow dynamic-group your_dynamic_group_name to inspect network-firewall-family in tenancy
ネットワークファイアウォールリソースのフレンドリ名の解決
Allow dynamic-group your_dynamic_group_name to inspect cloudevents-rules in tenancy
イベント・ルール・リソースのフレンドリ名の解決
Allow dynamic-group your_dynamic_group_name to inspect integration-instance in tenancy
インテグレーションインスタンスリソースのフレンドリ名の解決
ガイド付きウィザードまたはTerraformポリシーモジュールを再実行すると、これらが自動的に再適用されます。権限を復元した後も、コネクタが依然としてActive でない場合は、削除して再度作成してください。
リソース名がID文字列として表示されます 一部のOCIリソースタイプでは、New Relicは、生のリソース識別子を表示するのではなく、ログが最初に到着した直後に判読可能な名前(VCNやファイアウォール名など)を自動的に検索します。New Relicが特定のリソースを初めて認識する際、この検索に数分かかる場合があります。
これが表示された場合
その意味
リソースには最初にIDが表示され、その直後にフレンドリ名が表示されます。
正常 — これは新しいリソースが初めて表示される際に想定される動作です。
しばらく経ってもリソースにわかりやすい名前が付けられない
これは通常、権限の問題です — 以下をご覧ください。
特定のリソースタイプで、どのリソースにもわかりやすい名前が表示されません
一部のリソースタイプでは名前検索が有効になっておらず、常にIDが表示されます。これは想定される動作であり、エラーではありません。
名前が解決されない場合は、OCIテナンシのアドミニストレーターに、動的グループに不足している権限 にリストされているinspect個のポリシーがあることを確認するよう依頼してください — DNS、GoldenGate、ネットワーク・ファイアウォール、イベント・ルール、およびインテグレーション・インスタンスのリソースごとに1つずつです。権限が正しく設定されているように見え、適度な時間待っても名前が解決されない場合は、影響を受けるリソースの例とログのタイムスタンプを添えてサポートにお問い合わせください。
ダッシュボードにエラー、ギャップ、または予期しない値が表示される OCIログフォワーダーの監視ダッシュボードを有効にしている場合は、「ログが到着しているか」以外の確認事項について、まずこのダッシュボードを使用してください:
これが表示された場合
すべきこと
ダッシュボード上のすべてのウィジェットが空です。
インテグレーションのメトリクスオプション(セットアップ中に選択する設定です)をオンにしたこと、および基盤となる関数がOCIで実行されていることを確認してください。
ダッシュボードでエラー率が上昇しています。
最近セットアップを変更した直後にこの問題が発生し始めたかどうかを確認してください。何も変更しておらず、問題が継続している場合は、OCIネットワーク/ファイアウォールのルールがNew Relicへのアウトバウンド・アクセスを許可しているか確認し、New Relicのライセンスキーが引き続き有効であることを確認してください。
「records dropped」または類似のメトリクスがゼロ以外の値を示し、そのままの状態が続く
時間範囲を添えてサポートにお問い合わせください — 一部のログ・データがNew Relicに到達していません。
タイルに数値やパーセンテージの代わりにダッシュまたは値なしが表示される
何かが壊れていると判断する前に、より広い時間範囲を確認してください — これは多くの場合、エラーではなく「この時間枠にはまだ十分なデータがない」状態です。
その他のヘルプ 上記のチェックを行っても問題が解決しない場合は、以下の情報を添えてNew Relicサポートにお問い合わせください:
使用したセットアップ方法(ガイド付きウィザード、手動セットアップ、またはTerraform) OCIリージョン、および該当する場合は影響を受けるコンパートメント 問題が発生し始めたおおよその時間帯 上記のチェックのうち、すでにお試しいただいたもの 関連記事