Open Collector is installed. If you have not already installed it, follow the instructions in the Open Collector Installation and User Guide, and then return to this topic.
Set OpenCollector buffer size to 50000.
You have the required Salesforce credentials: Client ID and Client Password
The following port is open:
Initialize the Beat
Confirm the Open Collector is running:
You should see the open_collector and metrics version:
If Open Collector is not running correctly, see Troubleshoot the Open Collector in the Open Collector Installation and User Guide.
Run the following command to start the beat:CODE
./lrctl salesforcebeat start
Using the arrow keys, select New salesforcebeat instance from the list, and then press Enter.
Enter a unique identifier for this Salesforce beat instance, and then press Enter.
Enter the Salesforce beat domain name, and then press Enter.
Enter the Client ID for the Salesforce Beat configuration, and then press Enter.
Enter the Client Password for the Salesforce Beat configuration, and then press Enter.
Enter the hostname or IP Address of the Open Collector, and then press Enter.
Enter the port number on which open collector listens the request, and then press Enter.
The Salesforce Beat starts successfully.
To check the status of the service, run the following command:CODE
./lrctl salesforcebeat status
Salesforce Beat Notes
Since Salesforce is used to process extremely large logs, it is highly recommended to set the OpenCollector buffer size to 50000.
The Salesforce Beat will collect logs only once per day at 5 AM UST.
If the beat is started after/before 5 AM UST, it will collect logs that are available up to that time. The beat will run again at its scheduled time of 5 AM UST and collect all the logs once again. This may cause duplicate logs in the system.
If you wish to fetch logs from a particular date, you can provide the date in the salesforcebeat.yml file in the customPullDate field, using the YYYY-MM-DD format, and then restart the beat, whch will collect logs from that date. You will then have a one hour window to reset this field to blank to avoid repeated logs from that date. After resetting this field to blank, you will need to restart the beat for its regular functionality. This restart will collect logs of that day up to that time. This activity may also cause duplicate logs in the system.
Default Config Values for the Salesforce Beat
This field value should always be greater than 0.
This date is in the YYYY-MM-DD format. The Salesforce Beat will pull the data for the mentioned date only, if one has been entered. It will keep pulling the data for this date only after the Period time elapsed.
It is suggested to revert the date to blank after the logs have been pulled for the desired date.
The supported limit range is 1-1000.
This field can be changed to “true” when the log of today’s date is required.