<commit_before>---
title: Configuring Selected Third-Party Log Management Services
---

Instructions for configuring:

* [Logentries](#logentries)
* [Papertrail](#papertrail)
* [Splunk Storm](#splunkstorm)
* [SumoLogic](#sumologic)

Once you have configured the service, refer to [Third-Party Log Management Services](./log-management.html) to bind your application to the service.

## <a id='logentries'></a>Logentries ##

From your Logentries account:

1. Click the **Add new log** button.

    <%= image_tag("../images/third-party-logs/logentries-02.png") %>

1. Select **Manual Configuration**.

    <%= image_tag("../images/third-party-logs/logentries-03.png") %>

1. Enter the values for the **log**.

    <%= image_tag("../images/third-party-logs/logentries-04.png") %>

1. Note the assigned port.

    <%= image_tag("../images/third-party-logs/logentries-05.png") %>

    Logentries will accept connections on this port from any IP address for the
	specified time period.
	After the first connection is received, only connections from that IP
	address will be accepted.

1. Create the log drain service in CF.

    `$ cf cups my-logs -l syslog://api.logentries.com:<port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Select the host and log from the left-hand nav to view logs.

    <%= image_tag("../images/third-party-logs/logentries-08.png") %>

1. Click the **Live tail** button to see logs streaming from CF.

    <%= image_tag("../images/third-party-logs/logentries-09.png") %>

## <a id='papertrail'></a>Papertrail ##

From your Papertrail account:

1. Click the **Add System** button.

    <%= image_tag("../images/third-party-logs/papertrail-02.png") %>

1. Click the **Alternatives** link.

    <%= image_tag("../images/third-party-logs/papertrail-03.png") %>

1. Select **I use Heroku**, enter a name, and click **Save**.

    <%= image_tag("../images/third-party-logs/papertrail-04.png") %>

1. Note the URL with port that is displayed after creating the system.

    <%= image_tag("../images/third-party-logs/papertrail-05.png") %>

1. Create the log drain service in CF.

    `$ cf cups my-logs -l syslog://logs.papertrailapp.com:<port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Once Papertrail starts receiving log entries, the view automatically updates
to the logs viewing page.

    <%= image_tag("../images/third-party-logs/papertrail-11.png") %>

## <a id='splunkstorm'></a>Splunk Storm ##

From your Splunk Storm account:

1. Click the **Add project** button.

    <%= image_tag("../images/third-party-logs/splunkstorm-02.png") %>

1. Enter the project details.

    <%= image_tag("../images/third-party-logs/splunkstorm-03.png") %>

1. Create a new **input** for **Network data**.

    <%= image_tag("../images/third-party-logs/splunkstorm-04.png") %>

1. Allow automatic authorization of incoming IP addresses.
This will allow any IP address to connect and send logs for a period of 15
minutes, after which only recognized IP addresses will be accepted.

    <%= image_tag("../images/third-party-logs/splunkstorm-05.png") %>

1. Note the host and port provided for TCP input.

    <%= image_tag("../images/third-party-logs/splunkstorm-06.png") %>

1. Create the log drain service in CF using the displayed TCP host and port.

    `$ cf cups my-logs -l syslog://<host:port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Wait for some events to appear, then click **Data Summary**.

    <%= image_tag("../images/third-party-logs/splunkstorm-09.png") %>

1. Click the **loggregator** link to view all incoming log entries from CF.

    <%= image_tag("../images/third-party-logs/splunkstorm-10.png") %>

## <a id='sumologic'></a>SumoLogic ##

Note: SumoLogic uses HTTPS for communication; HTTPS is supported in Cloud
Foundry v158 and above.

From your SumoLogic account:<commit_msg>Formatting note<commit_after>---
title: Configuring Selected Third-Party Log Management Services
---

Instructions for configuring:

* [Logentries](#logentries)
* [Papertrail](#papertrail)
* [Splunk Storm](#splunkstorm)
* [SumoLogic](#sumologic)

Once you have configured the service, refer to [Third-Party Log Management Services](./log-management.html) to bind your application to the service.

## <a id='logentries'></a>Logentries ##

From your Logentries account:

1. Click the **Add new log** button.

    <%= image_tag("../images/third-party-logs/logentries-02.png") %>

1. Select **Manual Configuration**.

    <%= image_tag("../images/third-party-logs/logentries-03.png") %>

1. Enter the values for the **log**.

    <%= image_tag("../images/third-party-logs/logentries-04.png") %>

1. Note the assigned port.

    <%= image_tag("../images/third-party-logs/logentries-05.png") %>

    Logentries will accept connections on this port from any IP address for the
	specified time period.
	After the first connection is received, only connections from that IP
	address will be accepted.

1. Create the log drain service in CF.

    `$ cf cups my-logs -l syslog://api.logentries.com:<port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Select the host and log from the left-hand nav to view logs.

    <%= image_tag("../images/third-party-logs/logentries-08.png") %>

1. Click the **Live tail** button to see logs streaming from CF.

    <%= image_tag("../images/third-party-logs/logentries-09.png") %>

## <a id='papertrail'></a>Papertrail ##

From your Papertrail account:

1. Click the **Add System** button.

    <%= image_tag("../images/third-party-logs/papertrail-02.png") %>

1. Click the **Alternatives** link.

    <%= image_tag("../images/third-party-logs/papertrail-03.png") %>

1. Select **I use Heroku**, enter a name, and click **Save**.

    <%= image_tag("../images/third-party-logs/papertrail-04.png") %>

1. Note the URL with port that is displayed after creating the system.

    <%= image_tag("../images/third-party-logs/papertrail-05.png") %>

1. Create the log drain service in CF.

    `$ cf cups my-logs -l syslog://logs.papertrailapp.com:<port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Once Papertrail starts receiving log entries, the view automatically updates
to the logs viewing page.

    <%= image_tag("../images/third-party-logs/papertrail-11.png") %>

## <a id='splunkstorm'></a>Splunk Storm ##

From your Splunk Storm account:

1. Click the **Add project** button.

    <%= image_tag("../images/third-party-logs/splunkstorm-02.png") %>

1. Enter the project details.

    <%= image_tag("../images/third-party-logs/splunkstorm-03.png") %>

1. Create a new **input** for **Network data**.

    <%= image_tag("../images/third-party-logs/splunkstorm-04.png") %>

1. Allow automatic authorization of incoming IP addresses.
This will allow any IP address to connect and send logs for a period of 15
minutes, after which only recognized IP addresses will be accepted.

    <%= image_tag("../images/third-party-logs/splunkstorm-05.png") %>

1. Note the host and port provided for TCP input.

    <%= image_tag("../images/third-party-logs/splunkstorm-06.png") %>

1. Create the log drain service in CF using the displayed TCP host and port.

    `$ cf cups my-logs -l syslog://<host:port>`

1. Bind the service to an app, then restart or re-stage as necessary.

1. Wait for some events to appear, then click **Data Summary**.

    <%= image_tag("../images/third-party-logs/splunkstorm-09.png") %>

1. Click the **loggregator** link to view all incoming log entries from CF.

    <%= image_tag("../images/third-party-logs/splunkstorm-10.png") %>

## <a id='sumologic'></a>SumoLogic ##

<p class="note"><strong>Note</strong>: SumoLogic uses HTTPS for communication; HTTPS is supported in Cloud
Foundry v158 and above.</p>

From your SumoLogic account:
{'fraction_non_alphanumeric': 0.14922900471517778, 'fraction_numerical': 0.016566840830890786, 'mean_word_length': 3.6191877575044145, 'pattern_counts': {'":': 0, '<': 65, '<?xml version=': 0, '>': 65, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3308323', 'n_tokens_mistral': 2655, 'n_tokens_neox': 2450, 'n_words': 793}