Salesforce アプリケーションのログの収集

前提条件

アプリケーション ダッシュボードに表示されるすべてのデータを取得するには、Salesforce イベント モニタリング アドオンが必要です。  このアドオンにより、Salesforce EventLogFile、LoginEvent オブジェクト、トランザクション セキュリティ、Event Monitoring Analytics アプリケーションのすべてのイベント タイプにアクセスできます。詳細については、「Get Started with Event Monitoring (イベント モニタリングの開始)」および「Enable Event Monitoring (イベント モニタリングの有効化)」を参照してください。

プロセス概要

このページでは、新規インストールとアップグレード インストールの手順を説明します。

• Salesforce 用の新規の SumoJanus インストール環境の設定
• Salesforce 用の既存の SumoJanus インストール環境のアップグレード

ステップ 1: Salesforce ユーザ権限の設定

権限セットを作成してユーザに割り当てる手順

1. Salesforce で、[設定] > [管理] > [ユーザの管理] > [権限セット] に移動します。  
2. 「API の有効化」権限と「イベントログファイルを参照」または「すべてのデータの参照」権限のいずれかを使用して権限セットを作成します。詳細については、Salesforce ヘルプの「Create Permission Sets (権限セットの作成)」を参照してください。
3. [権限セット概要] > [システム権限] ページで、[API の有効化] および [イベントログファイルを参照] を選択します。
   
4. 作成したばかりの権限セット内にある [割り当ての管理] ボタンをクリックして、[割り当てを追加] をクリックします。
5. ユーザを見つけ、そのユーザを作成したばかりの権限セットに割り当てます。
6. 変更内容を保存します。

ステップ 2: Collector のインストールと SumoJanus パッケージのダウンロード

このセクションでは、Sumo Logic Collector をインストールして、必要な SumoJanus パッケージをダウンロードします。

ステップ 3: SumoJanus パッケージのデプロイ

このセクションでは、SumoJanus を新規にインストールする手順を説明します。 

ステップ 4: SFDC バンドルの設定

1. 展開した sumojanus-salesforce フォルダに移動します。
2. conf/sumologic.properties ファイルを開き、次のセクションをファイルの末尾に追加します (ファイルの既存の内容は一切上書きしないでください)。
   
   [salesforce]
url = <Salesforce Instance URL>
token_file_path = ${path}/data/salesforce.token
record_file_path = ${path}/data/sf_readfiles.dat
# if you are using a SFDC sandbox environment, set the following to true
sandbox = false
interval = daily
    
3. 以下のプロパティを設定します。
   1.  url—Salesforce URL を参照します。例:
      https://na25.salesforce.com
   2. sandbox—サンドボックス環境を使用している場合は、このプロパティを true に設定します。デフォルトでは false に設定されています。
   3. start_time—start_time を指定しない場合、過去 2 日間のログが収集されます。
   4. interval—日次ログを収集するか 1 時間ごとのログを収集するかを制御します。この手順の後半にある「ステップ 7: スクリプト Source の設定」で指定する [Frequency (頻度)] の設定は interval 設定に対応する必要があります。

conf/sumologic.properties ファイルでは、以下のプロパティがサポートされています。

ステップ 5: JRE パスの設定

Windows での SumoJanus_SF.bat の更新

SumoJanus をインストールしたフォルダに移動し、テキスト エディタで SumoJanus_SF.bat を開きます。下記のように、このスクリプトの 3 行目で JAVAPATH が C:\Program Files\Sumo Logic Collector\jre\bin に設定されています。

set JAVAPATH="C:\Program Files\Sumo Logic Collector\jre\bin"

Collector の JRE が別の場所にある場合は、それに合わせて 3 行目を更新します。  

Linux での SumoJanus_SF.bash の更新

SumoJanus をインストールしたフォルダに移動し、テキスト エディタで SumoJanus_SF.bash を開きます。次のようにスクリプトを更新します。

1. JRE の場所を参照するように JAVA_HOME  を設定する行をスクリプトの最後の行の直前に追加します。たとえば、Collector の JRE が /opt/SumoCollector/jre/bin にある場合は、次の行を挿入します。
   
   JAVA_HOME=/opt/SumoCollector/jre/bin

2. スクリプトの最後の行は次のとおりです。
   
   java -jar ${SUMOJANUS_JAR_FILE} ${runMode} SalesforceCollector-3.1.0.jar -e 1800
   
   次のように、この行の前に $JAVA_HOME/ を付けます。
   
   $JAVA_HOME/java -jar ${SUMOJANUS_JAR_FILE} ${runMode} SalesforceCollector-3.1.0.jar -e 1800

ステップ 6: Salesforce での認証

上記のステップが完了したら、このセクションで説明する作業を使用して、インストールを認証する必要があります。

インストールを認証するには、次の手順を実行します。

1. Salesforce をログアウトします。>
2. 展開した sumojanus-salesforce フォルダで次のコマンドを実行します。
   • Unix 系のシステムの場合: bin/SumoJanus_SF.bash -s
   • Windows の場合: bin\SumoJanus_SF.bat -s
3. ブラウザが開きます (開かない場合、下記の「ブラウザが開かない場合」を参照)。
   • ブラウザがすでに Salesforce で認証されている場合、アクセス権が付与されたことを示すメッセージが表示されます。
   • 認証していない場合、Salesforce ログインが表示されます。資格情報を入力 (必要な権限あり) してアクセス権を付与します。
4. トークン ファイルが作成されたことを示す次のメッセージが表示されます。
   
   
5. bin/SumoJanus_SF.bash -sを実行したセッションは閉じないでください。

ステップ 7.スクリプト Source の設定

Sumo Logic で、「スクリプト Source」の手順に従ってスクリプト Source を設定します。バージョン 19.245-4 以降の新しい Collector では、スクリプト Source の作成はデフォルトでは禁止されています。スクリプト Source を許可するには、user.properties 内の Collector のパラメータ enableScriptSource=true を true に設定する必要があります。

Salesforce 用の Sumo Logic アプリケーションでは、次の設定を使用します。

• Frequency (頻度): 
  • 日次ログ ファイルの場合、頻度を 6 時間ごとに設定します。
  • 1 時間ごとのログ ファイルの場合、頻度を 1 時間に設定します。 
• Specify a timeout for your command (コマンドのタイムアウトを指定):
  • 日次ログ ファイルの場合、タイムアウトを 3 時間ごとに設定します。 
  • 1 時間ごとのログ ファイルの場合、タイムアウトを 1 時間に設定します。
• Command (コマンド): /bin/bash
  • Unix 系のシステムの場合: /bin/bash
  • Windows の場合: Windows スクリプト 
• 実行するスクリプトのパスの入力
  [Working Directory (作業ディレクトリ)] に sumojanus フォルダのフル パスを設定します。以下に例を示します。
  • Unix 系のシステムの場合: /opt/SumoCollector/sumojanus/bin/SumoJanus_SF.bash
  • Windows の場合: c:\Program Files\SumoCollector\sumojanus\bin\SumoJanus_SF.bat