Splunk Observability Cloud の iOS インストルメンテーションのトラブルシューティング 🔗

Splunk OpenTelemetry Instrumentation for iOS を使用して iOS アプリケーションをインストルメンテーションし、Splunk Observability Cloud にデータが表示されない場合は、以下のトラブルシューティング手順に従ってください。

iOSのOpenTelemetry問題のトラブルシューティングの手順 🔗

以下の手順は、iOS RUMライブラリの問題のトラブルシューティングに役立ちます：

互換性と必要条件をチェック
複数のツールを使っていないか確認する
デバッグロギングを有効にする

互換性と必要条件をチェック 🔗

互換性のあるバージョンと要件の完全なリストについては、互換性と必要条件をチェックを参照してください。

複数のツールを使っていないか確認する 🔗

開発・観測ツールの中には、Splunk RUM と同様の機能を持つものがあります。クラッシュレポートなど、同じ目的で複数のツールを使用すると、動作が未定義になる可能性があります。各目的には1つのツールだけを使用してください。

デバッグロギングを有効にする 🔗

デバッグロギングを有効にすると、iOSインストルメンテーションの問題のトラブルシューティングに役立ちます。

ロギングを有効にするには、SplunkRumBuilder に debug(enabled: true) メソッドを追加します。例：

import SplunkOtel
//..
SplunkRumBuilder(realm: "<realm>", rumAuth: "<rum-token>")
// Call functions to configure additional options
   .debug(enabled: true)
   .build()

注釈

必要なときだけデバッグロギングを有効にします。デバッグモードはより多くのリソースを必要とします。

iOS のメトリクスが Splunk RUM に表示されない 🔗

Splunk RUM で iOS アプリのテレメトリが見つからない場合は、以下をお試しください：

シミュレータのデバッグログを検索するには、デバッグロギングを有効にします。デバッグロギングを有効にするを参照してください。
rumAuth と realm の値が正しく定義されていることを確認します。
- RUMトークンはアクティブでなければならず、データを送信しようとしている組織の一部でなければなりません。
- レルムは、組織のレルムと同じでなければなりません。

Splunk レルムを見つけるには、レルムに関する注意事項を参照してください。

カスタム beaconUrl を定義している場合は、その値が正しいことを確認してください。

HTTP リクエストが Splunk RUM に表示されない 🔗

HTTP リクエストが Splunk RUM に表示されない場合は、以下をお試しください：

使用しているライブラリを確認してください。Splunk RUM は、非推奨の Apple NSURLConnection API をサポートしていません。Splunk RUM for iOS は Apple URLSession ベースのライブラリをサポートしており、これには AFNetworking や AlamoFire などのライブラリも含まれます。
他のテレメトリ・ライブラリまたはSDKが既に構成されている場合は、ignoreUrls 設定を使用します。一般設定を参照してください。
ネットワークコールのキャプチャには Splunk RUM のみを使用することを検討してください。ネットワークコールをキャプチャするライブラリやツールが複数あると、問題や未定義の動作が発生する可能性があります。

Splunk RUM にクラッシュが表示されない 🔗

クラッシュ情報が Splunk RUM に表示されない場合は、以下をお試しください：

Splunk RUM のクラッシュレポート機能だけがアクティブなクラッシュレポーターであることを確認してください。たとえば、Crashlytics も使用している場合は、その機能を無効にしてもう一度試してください。
RUMライブラリがレポートを送信できるように、クラッシュ後にアプリケーションを開いていることを確認してください。

名前の衝突を避ける 🔗

あなたのコードが名前の衝突を引き起こす場合は、使用したいシンボルを含むモジュールを追加します。たとえば、SplunkOtel も宣言している型を宣言する場合は、そのモジュール名をプレフィックスとして追加します。

import SplunkOtel
//..
var a = MyModule.MyConflictingType()

Xcodeがパッケージの依存関係を解決できない 🔗

Splunk RUM がすでに使用している依存関係のいずれかを使用する場合は、そのバージョンがバージョン管理ルールに解決できるかどうかを確認してください。GitHub リポジトリの dependencies.txt ファイルを参照してください。

Xcode は依存関係の解決に失敗したことを通知する可能性があります。バージョニングルールの問題が表示されない場合は、Xcode を閉じて開き直し、パッケージを再度追加してみてください。

SQLiteの再定義エラーを避ける 🔗

WCDBのようにSQLiteを使う他のツールを使っている場合は、Podfileの use_frameworks! 行を use_modular_headers! で置き換えます。

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

見込み客および無料トライアルユーザー様

Splunk Answers のコミュニティサポートで質問し、回答を得る
Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルのチャットグループを参照してください。

このページは 2024年12月09日に最終更新されました。

Related Topics