Salesforce for Android and iOS でのパフォーマンス問題のトラブルシューティング

Salesforce for Android and iOS でのパフォーマンス問題のトラブルシューティングガイド

Salesforce モバイルアプリのパフォーマンスが低下している場合、このガイドではその問題を診断し解決するための手順を説明します。これらの基本的なトラブルシューティング手法や高度なトラブルシューティング手法を活用して、読み込みの遅延、フリーズ、エラーの根本原因を特定し、アプリのパフォーマンスを回復させてください。

初期のトラブルシューティング：

1. ネットワーク接続を確認する

モバイル接続はSalesforce アプリにとって不可欠なものです。通信事業者や Wi-Fi の信号品質は場所によって大きく異なる場合があります。

• 対処法：Wi-Fiとモバイルデータ通信(5G、4G/LTE) を切り替えてみてください。あるネットワークではアプリのパフォーマンスが劇的に向上する場合、問題はSalesforceアプリ自体ではなく通信速度の遅いネットワーク側にある可能性が高いです。

2. ソフトウェアを常に最新の状態に保つ

古いソフトウェアはパフォーマンスや互換性の問題を引き起こすよくある原因です。アップデートには重要なバグ修正やパフォーマンスの向上が含まれていることがよくあります。

• アプリソフトウェア：Salesforceアプリの古いバージョンをすべてアンインストールし、Apple App StoreまたはGoogle Play Storeから最新バージョンをインストールしてください。
• オペレーティングシステム(OS)：お使いの端末がiOSまたはAndroidの最新バージョンを実行していることを確認してください。端末の設定メニューでアップデートがあるか確認してください。

3. アプリのキャッシュを消去する

Salesforceアプリは情報の読み込みを高速化するために一時データ(キャッシュ)を保存します。場合によってはこのデータが古くなったり破損したりすることがあり、その結果読み込み中のアイコンがいつまでも表示されたりエラーが発生したりすることがあります。

• 対処法：「Salesforce for Android and iOSのキャッシュをクリアする」に関する公式の手順に従い、アプリの一時データを更新してください。

4. ランディングタブを最適化する

アプリを開いたとき、最初に目に入るのは何ですか？もし複雑なページが表示される場合、それが起動に時間がかかる原因となっている可能性があります。「行動」や「今日」といった動的な情報を表示するタブあるいはカスタム Lightning/Visualforce ページは、読み込みに多くのデータが必要となります。

• 対応策：読み込み速度の向上に最適化された新しい「販売業者重視のモバイル環境」にランディングページを更新することをご検討ください。設定の詳細についてはこちらをご覧ください：「販売業者重視のモバイル環境の設定」

高度なトラブルシューティング：

基本的な手順で問題が解決しなかった場合は、さらに詳しく調べてみましょう。これらの手順を踏むことでパフォーマンスのボトルネックの正確な原因を特定するのに役立ちます。

1. アプリ内ネットワークテストを使用する

Salesforceアプリには、アプリ側の視点から直接接続品質を測定できる機能が組み込まれています。

• アクセス方法：Salesforce アプリにて [設定] > [詳細設定] > [ネットワークのテスト] の順に選択します。
• 分析項目：
  • Ping：遅延(レイテンシ) を測定します。Ping 時間が長いほど接続の応答性が低くなります。
  • ダウンロード/アップロード速度：帯域幅を測定します。速度が遅いとレコード、ファイル、ページの読み込みが遅くなる可能性があります。

2. 実測ページ滞在時間(EPT)を分析する

EPTはページが完全に読み込まれユーザーが操作できるようになるまでの時間を測定する重要な指標です。この機能を有効にすると、アクセスした各ページの上部にEPTが秒単位で表示されます。

• 有効にする方法：
  • iOS：[設定] > [詳細] > [パフォーマンス評価を有効にする] の順に選択します。
  • Android：[設定] > [詳細] > [Lightning設定] > [パフォーマンス評価を有効にする] の順に選択します。

• 操作：この設定を有効にした後アプリを再起動してください。アプリ内を操作し特に動作が遅く感じるページに注意を払ってください。特定のページでEPTの値が高い場合は、そのページの設定やコンポーネントに問題があることを示しています。

3. メモリ使用量の監視(iOSのみ)

iOSユーザーは、Salesforceアプリ内で、アプリが消費しているデバイスメモリの量を直接確認できます。

• 有効にする方法：[設定] > [詳細設定] > [メモリ使用量を表示] の順に選択します。メモリ使用量が高い場合は、複雑なページやデバイスのリソースに負荷をかけている機能がある可能性があります。

4. Salesforceのデバイスログの取得

アプリがバックグラウンドで具体的にどのような処理を行っているかを確認したい場合、イベントログは有用な情報源となります。

• 取得方法：アプリで、[設定] > [詳細設定] > [イベントログの送信] の順に選択します。
• 重要な注意事項：ログを送信する際、メールの「宛先」欄には宛先が自動的に入力されます。このアドレスを変更しないでください。ただし、ご自身のメールアドレスとケースを担当するSalesforceサポートエンジニアのメールアドレスをCCに追加してください。詳細な手順については「Salesforce for Android and iOS のデバイスログを Salesforce サポートへ送信する方法 」を参照してください。

5. ネットワークログ（HARファイル）の取得

ネットワークの遅延や非効率的なAPI呼び出しは、動作が遅くなるよくある原因です。プロキシツールを使用するとアプリとSalesforceサーバー間のすべてのネットワークトラフィックを傍受して確認することができます。これは分析用の詳細なHAR(HTTP Archive)ファイルを取得するのに最適な方法です。

• ツール：Charles Proxy または Fiddler。
• 手順：
  1. お使いのコンピュータにプロキシツールをインストールします。
  2. モバイルデバイスの Wi-Fi 設定を変更し、コンピュータをプロキシとして使用するように設定します。
  3. HTTPS トラフィックを復号化するために、モバイルデバイスにツールの SSL 証明書をインストールします。
  4. Salesforce アプリで動作が遅くなる現象を再現します。
  5. キャプチャしたトラフィックを分析し処理が遅いAPI呼び出し、大きなペイロード、またはエラーを特定します。
  6. セッションをHARファイルとしてエクスポートし、Salesforceサポートに共有します。
• 別の方法：コンピュータ上でXcodeシミュレータ(iOS)またはAndroid Studioエミュレータ(Android)を使用することもできます。これにより、シミュレートされた環境でSalesforceアプリを実行しブラウザの開発者ツールを使用してHARログをキャプチャしパフォーマンスを監視することができます。

注：これは、シングルサインオン(SSO) の問題の診断や、SSOのパフォーマンス評価においても非常に有益です。

6. システムログおよびクラッシュログの取得

アプリがフリーズしたりクラッシュしたりその他の異常な動作が見られる場合、デバイス自体のシステムログからスタックトレースやその他の重要な診断情報を取得できます。

• iOSの場合(分析データ)：
  1. デバイスで、[設定] > [プライバシーとセキュリティ] > [分析と改善] > [分析データ] の順に選択します。
  2. Salesforceアプリに関連するログファイル(Chatter-YYYY-MM-DD-XXXX.ips)を探します。
  3. AirDropまたはメールを介して、そのファイルをコンピュータに共有します。
• Androidの場合(ADB Logcat)：
  1. デバイスで「開発者向けオプション」と「USBデバッグ」を有効にします。
  2. デバイスをUSB経由でコンピュータに接続します。
  3. コマンドプロンプトまたはターミナルを開き、次のコマンドを実行します：adb logcat -d > logfile.txt
  4. クラッシュやフリーズを再現し、直後にコマンドを停止して関連するログを取得します。

7. パケットキャプチャ(PCAP)の実行 - iOSのみ

Salesforceモバイルアプリのパケットキャプチャ(PCAP)を実施することは認証エラーやセキュリティ上の懸念、詳細なネットワークパフォーマンス分析など、さまざまなネットワーク関連の問題のトラブルシューティングに役立ちます。ネットワークトラフィックをキャプチャして分析することでチームはアプリがSalesforceサーバーとどのように通信しているかについてより深い洞察を得ることができAPIリクエストの失敗、SSL/TLSエラー、応答時間の遅延などの問題の特定に役立ちます。

• Macにデバイスを接続する：USBケーブルを使って iOSデバイスをMacに接続します。
• デバイスのUDIDを確認する：MacでXcodeを開き [Window] > [Devices and Simulators] の順に選択し、お使いのデバイスの一意のデバイス識別子（UDID）を確認します。
• RVIの作成：ターミナルを開き次のコマンドを実行してデバイスのトラフィックをミラーリングする仮想ネットワークインターフェースを作成します： rvictl -s <お使いのデバイスのUDID>
• Wiresharkでのキャプチャ：MacでWiresharkを開きます。インターフェース一覧に新しいインターフェース（例：rvi0）が表示されます。このインターフェースを選択し、キャプチャを開始します。
• キャプチャの停止：終了したら Wiresharkでキャプチャを停止し、ターミナルで次のコマンドを実行してRVIを無効にします： rvictl -x <お使いのデバイスのUDID>

エキスパートによるサポート：Salesforceカスタマーサポートにご連絡ください

分析は完了したものの解決策が見つからない場合は、弊社のサポートチームがサポートいたします。Salesforceカスタマーサポートにケースを作成し、できるだけ詳しい情報を記載してください。

サポートケースに記載すべき内容：

1. 問題を再現するための具体的な手順 お客様が実際に目にする状況を、私たちにも把握できるようご協力ください。詳細は多ければ多いほど助かります。

• 良い例：
  • iPhone 14 Pro で Salesforce for iOS アプリを開きます。
  • [取引先] タブに移動します。
  • [新規] ボタンをクリックします。
  • ページの読み込みに10秒以上かかります。
• より適切な例(技術者向け)：
  • 上記の例のすべての手順に加え、以下の点があります。
  • [新規] ボタンは、VF_Account_Alert_New という名前の Visualforce ページを起動するよう上書きされています。
  • Visualforce ページへのリンク：https://[MyDomain].my.salesforce.com/apex/VF_Account_Alert_New
  • このページはすべてのプロファイルからアクセス可能であり、Apex クラスの AccountController および AlertUtility を呼び出します。
  • カスタムページを使用しない場合はユーザーのプロファイルに割り当てられている 取引先レコードタイプを指定してください。

2. ご利用環境の詳細 ご利用中の具体的なハードウェアおよびソフトウェアをご記入ください。

• 例1：「この問題は Android 13 を実行している Samsung Galaxy S23 上の『Salesforce for Android v256.0』で発生します。」

• 例2：「この問題は iPadOS 16.5 を実行している『iPad Pro 12.9』上の『Salesforce for iOS v256.0』で発生します。」

  • 注：問題がモバイルアプリでのみ発生しデスクトップ版サイトでは正常に動作する場合は、その旨を明記してください。

3. 問題の経緯　この問題はいつから発生しましたか？これを把握することで考えられる原因を絞り込むことができます。

• 例：「この動作の遅さは当社の組織が『Summer '25』リリースに更新された後に発生し始めました」や、「この問題は、Salesforceアプリのバージョン256.0に更新した直後に発生しました」

4. ネットワークおよび接続の詳細

• どのようなネットワークをご利用ですか？(例：Wi-Fi、5G、4G/LTEなど)
• 企業のVPNやファイアウォールが設定されている可能性のあるセキュアなWi-Fiネットワーク経由で接続していますか？

5. 収集したすべてのログおよびファイル トラブルシューティングの過程で収集した関連ファイルをすべて添付してください。これには以下が含まれます：

• 問題が発生している画面のスクリーンショットまたは画面録画
• Charles Proxy または Fiddler からの HAR ファイル
• デバイスのイベントログ、クラッシュログ、またはシステムログ
• 特定のページにおける高い EPT 値の一覧

この体系的なトラブルシューティングの手順に従うことでパフォーマンスの問題を効果的に診断し、迅速な解決に必要な情報を提供することができます。