Fix: reinstate sumo logic docs.

Author: teesloane

jekyll/_cci2/insights.md

@@ -101,6 +101,94 @@ The per-project insights page gives you access to the build status and build per
 
 - **Build Performance:** The Build Performance graph aggregates your build/job data for a particular day and plots the median for that day going back as far as 90 days. Monitor the performance of your repo by clicking a particular branch.
 
+
+## Sumo Logic Integration
+
+Sumo Logic users may track and visualize analytical data across all of their
+jobs on CircleCI. To do so, use the Sumo Logic Orb and Sumo Logic app
+integration from the Sumo Logic partner integrations site.
+
+
+### The CircleCI Dashboard for Sumo Logic
+
+![header]({{ site.baseurl }}/assets/img/docs/CircleCI_SumoLogic_Dashboard.png)
+
+Included panels:
+
+- Total Job
+- Total Successful Jobs
+- Total Failed Jobs
+- Job Outcome
+- Average Runtime in Seconds (by Job)
+- Jobs By Projects
+- Recent Jobs (latest 10)
+- Top 10 Slowest Failed Jobs In Seconds
+- Top 10 Slowest Successful Jobs In Seconds
+
+Install the CircleCI dashboard by using the App Catalog from the dashboard home page.
+
+![header]({{ site.baseurl }}/assets/img/docs/sumologic_app_catalog.png)
+
+This dashboard receives data through the CircleCI Sumo Logic orb which must be included in your projects to be tracked.
+
+### The Sumo Logic Orb
+
+Find the latest version of the Sumo Logic orb on the [Orb Registry](https://circleci.com/orbs/registry/orb/circleci/sumologic).
+
+#### 1. Import the Sumo Logic orb.
+Add the Sumo Logic orb to your project by including the top-level `orbs` key and import `circleci/[email protected]` as follows, replacing `x.y.z` with the latest version number at the link above.
+
+```yaml
+orbs:
+  sumologic: circleci/[email protected]
+```
+
+#### 2. Add _Workflow-Collector_ to Workflow.
+The `workflow-collector` job runs concurrently along side your workflow and sends analytics to Sumo Logic until all of the jobs in your workflow have completed.
+
+```yaml
+version: 2.1
+workflows:
+  build-test-and-deploy:
+    jobs:
+      - sumologic/workflow-collector # add this job to track workflow.
+      - build
+      - test:
+          requires:
+            - build
+      - deploy:
+          requires:
+            - test
+```
+#### 3. Create two source collectors.
+You will need to create two *source collectors* on Sumo Logic which will return an HTTPS URL. Your job data will be sent to this HTTPS URL.
+
+You will need to create one called `circleci/job-collector` and another called `circleci/workflow-collector`.
+
+To create the two source collectors:
+1. From the dashboard select the **Setup Wizard**.
+2. Select **Set Up Streaming Data**.
+3. Scroll to the bottom and select **All Other Sources**.
+4. Select **HTTPS Source**
+5. For the `Source Category` enter one of the two mentioned above.
+6. Save the resulting URL.
+
+#### 4. Add environment variables.
+For each of the URLs produce in the previous step, create the corresponding environment variable.
+
+Env vars:
+- `JOB_HTTP_SOURCE`
+- `WORKFLOW_HTTP_SOURCE`
+
+**[How to add an environment variable to your project.]({{ site.baseurl }}/2.0/env-vars/#setting-an-environment-variable-in-a-project)**
+
+This will link the orb with your Sumo Logic dashboard.
+
+Your Sumo Logic dashboard will now begin to populate with data as each job runs on CircleCI.
+
+## See Also
+Refer to the [Orbs Introduction]({{ site.baseurl }}/2.0/orb-intro/) document to learn more about using and authoring orbs.
+
 ### See Also
 
 Refer to the [Collecting Test Metadata]({{ site.baseurl }}/2.0/collect-test-data/) document for instructions to configure insights into your most failed tests.