Skip to content

Instantly share code, notes, and snippets.

@maglietti
Last active August 29, 2015 14:26
Show Gist options
  • Save maglietti/7e1c592f519abb80d0e3 to your computer and use it in GitHub Desktop.
Save maglietti/7e1c592f519abb80d0e3 to your computer and use it in GitHub Desktop.
Cloud Monitor Instrumentation

Connecting your Cloud Monitor to Sumologic

Monitoring is frequently at the top of the priority list for Akamai's customers. The best product to get this information currently is the Cloud Monitor. Akamai has partnered with Sumologic as a system designed to analyze and display metrics and reports from Akamai's traffic. Setting this up is usually something done by Professional Services, but it is relatively easy to set it up yourself, and that's what I'm going to cover here. When you're done, you will have a working integration between cloud monitor and Sumologic, and you can manage the information in Sumologic like any other data set.

This tutorial assumes you already have Cloud Monitor set up on your Akamai account.

  1. Set up a Sumologic trial account.

    If you don't already have a Sumologic account, you can set up a trial account with them for testing. The trial account offered by Sumologic is free, and doesn't require any credit card or other guarantee.

  2. Browse to SumoLogic

  3. Select the "Free Trial" button from the upper right hand corner.

  4. Enter your company email address, agree to the Service License Agreement, and Submit.

  5. Check your email for an email asking you to Activate your Account and click the button.

  6. Configure Sumologic to accept cloud monitor data.

    Once you have a Sumologic account, you can configure an http collector to collect the data POSTed to Sumologic by cloud monitor.

    1. When you return to the site you will be placed on a page with the setup wizard.
    2. Select "Setup Streaming Data" => "All Other Sources" =>"HTTP Source".

    HTTP Source

    1. You will be assigned a special URL for cloud monitor to POST to. You need the whole URL, including server and path.

    HTTP Source

    Store this information somewhere safe while you set the system up. Don't move beyond this step on the Sumologic side or you will need to set up the collection from scratch later.

  7. Setting up your main property

    To get this working, you will need to instrument your main property to log data to another Akamai property, which will hand off the log data to Sumologic. We recommend that you call that intermediate property "cloudmonitor..". As an example, I'll use my own domain, princesspolymath.com.

    1. Open Luna Control center and navigate to the property you want to work with.
    2. Create a new version for the property and select it.
    3. Scroll down to the Property Manager configuration section.
    4. Click "Add Rule" and select the "Cloud Management" section, adding the "Cloud Monitor Instrumentation"
    5. Note that you are only putting the "path" part of the URL here, not the server name. This is very important to make it work.

    Cloud Monitor Instrumentation

  8. Setting up your intermediate (collector) property

    Now we will set up a new property in Luna.

    1. From the same screen where you see your main property, add a new property.
    2. Make sure that you apply your TLS certificate to this property so it can handle HTTPs traffic.
    3. For this property, you need to set up the origin server as the server from the Sumologic target URL obtained earlier.
    4. Make sure that your port is set to 443 at the bottom of this section.

    Collector Property

  9. Finish the Sumologic Setup

    1. We will finish the Sumologic piece now. Earlier, you were redirected to a page with information about your collectors. If you already went through the finishing steps, you can go through again by going to Configure => Setup Wizard.
    2. From the collector page, click Library=>Apps=>Akamai Cloud Monitor
    3. Click Install
    4. On the setup page, set your _sourceCategory values to "akamai_cloud_monitor" as we did during setup.

    If all has gone well, you will have a setup like the following: Sumologic Status

As data begins to collect in Sumologic, the Manage... Dashboards... Status page will start to have results from the posts.

Sumologic QOS

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment