Topologies API Lab

Moogsoft Enterprise topologies are systems of nodes connected by bidirectional links that represent aspects of your IT system. For example, you can create a topology to describe network hardware, software components, or geographic regions. By using a topology to filter alerts in your Cookbook Recipes, you can analyze the impact of a fault in one node on its nearby neighbors. You can maintain your topology using the Topology Application Programming Interface (API).

After you complete this lab, you will be able to:

In a production system, your monitoring system would send data continuously to Moogsoft Enterprise, and you would probably embed Topology API calls in other programs. For this lab you'll send individual events and API calls to Moogsoft Enterprise from your Linux terminal using cURL commands.

Before You Begin

To get started, request a lab instance and then log into the Moogsoft Enterprise user interface and the Linux operating system on your instance.

  1. If you are a Moogsoft partner or customer, request a virtual lab instance pre-provisioned with data here.

  2. Review the documentation links above.

  3. Allow up to two days to receive an email with your instance details. The email will include a URL you can use to access the Moogsoft Enterprise user interface (UI) in a web browser. It will also include ssh credentials for logging into the operating system of your lab instance using a terminal program.

  4. Go to your URL and click through any security warnings.

    Note

    If you cannot get through the security warnings, try using a different browser. If you are using Chrome with a recent version of the Macintosh operating system, you can click anywhere on the page, type ‘thisisunsafe’, and hit return to get to the login page.

  5. Log into Moogsoft Enterprise using the username 'admin' and the password 'admin'.

  6. Using a terminal program, log into your instance operating system using ssh and your username and password. The examples in this lab use tanisha-johnson as the username and https://tanisha-johnson-topo.datalab.moogsoft.com as the URL.

    ssh tanisha-johnson@tanisha-johnson-topo.datalab.moogsoft.com
  7. Change to the superuser so that you can access files in the Moogsoft home directory.

    sudo su
  8. Arrange your computer desktop so you can easily switch back and forth between the user interface and the terminal.

  9. As you complete each lab section, read the overview and then refer to the step by step instructions for additional details.

  10. If you are interested in learning more about topology features after you complete the lab, watch the video Create Topologies Dynamically to learn how to use the Workflow Engine to parse incoming alerts and create and update topologies dynamically.