5. Locations

Using Locations is much like using systems and groups only the intent is to use locations as logical groupings for physical locations of systems. They can be as general as city and state or as specific as rack or closet. It is completely customize-able. Note that locations also do not appear on the Dashboard. Even though they do not appear on the dashboard, they still help to create additional organizers for monitoring or alerting.

5.1. Google Maps Geographic View of Network Health

5.1.1. Overview

Zenoss can map Locations using a Google Maps mashup feature by setting the Location's "Address" property to an address that Google Maps considers valid.The selected Location will appear on the map as a dot. The color of the dot represents the highest severity of any event on any device under that Location. In addition, network connections that span Locations will be represented on the map by lines also color-coordinated to the appropriate to the status of that connection.

To access the Google Map of a network Location, from the left navigation menu, click Locations, select the Location want to see the network map, and click the Map tab. The Network map is also one of the portlets you can add to the dashboard.

5.1.2. API Key

Before you can use the Google Maps feature, you must register for a Google Maps API key. Free Google Maps API keys are linked to a base URL by which an application must be accessed for Google Maps to function. Enterprise customers do not have this limitation.

To obtain a free Google Maps API key:

  1. Point your browser to: http://www.google.com/apis/maps/signup.html

  2. Fill in the URL by which you access your Zenoss web interface. Include the port. For example, "http://localhost:8080".

    Users accessing the Zenoss web interface via a different URL than the one you specify here (for example, by IP instead of hostname) will not be able to use the Google Maps feature.

  3. Agree to the terms and click OK to receive your API key. Copy it to the clipboard.

5.1.3. Setting an Address for a Location

  1. From the left navigation menu, select Locations.

  2. From the Summary table, next to Address, click Edit.

    An Edit dialog slides down.

  3. In the New Address field, enter a complete address that can, be resolved by Google Maps (if you're unsure, head to http://maps.google.com and see if it maps).

  4. Click the Save button.

    You have now created the adress for the loation that will appear on the map for this location. You must add devices (at least one) to the Location for the dot to appear on the map.

5.1.4. Network Links

If two devices in the same network are in different mappable Locations, a line will be drawn on the map representing a network connection between the two. If there are multiple separate network connections between the same two Locations, only one line will be drawn. The color of the line will represent the highest severity of any events affecting the connection. These are determined by:

  • A ping down event on the device at either end of the connection; or

  • Any event on the interface at either end of the connection.

5.1.4.1. zDrawMapLinks Property

Calculating network links on the fly is an expensive procedure. If you have a large number of Devices that have been assigned Locations, drawing those links on the map may take a long time. In order to save time, you can tell Zenoss not to attempt to draw links for specific networks (for example, a local network comprising many devices that you know does not span multiple Locations).

  1. Navigate to the Network and click the "zProperties" tab.

  2. Set the "zDrawMapLinks" property to "False."

  3. Click "Save."

    Like all zProperties, that setting will be inherited by all subnetworks. If you have few networks for which links would be drawn, it might be a good idea to set zDrawMapLinks to False on /Networks, and only set it to True on a network where you know a Location-spanning WAN connection exists.

5.1.5. Google Maps Example

This example will walk you through creating and displying some google map links of devices and sending a test event to see how the links are affected by changes in the system.

  1. Navigate to /Network, click "zProperties" and set "zDrawMapLinks" to False. Save.

  2. Navigate to /Locations and create two sub-Locations, called "New York" and "Los Angeles".

  3. Go to the Status tab of each of the two new Locations. Set the "Address" property of each to "New York, NY" and "Los Angeles, CA" respectively.

  4. Set the location of a device in Zenoss to /Locations/New York. Find another device on the same network and set its location to /Locations/Los Angeles.

  5. Navigate to /Locations and click on the "Map" tab. Notice that both New York and Los Angeles are represented as dots on the map, but that there is no link drawn between the two.

  6. Now navigate to the Network to which both devices are connected. Click the "zProperties" tab and set "zDrawMapLinks" to True. Save.

  7. Navigate back to the "Map" tab of /Locations. Notice that a green line is now drawn between New York and Los Angeles.

  8. Send an event (See Chapter 10, Section 4 of this guide) to the device in /Locations/New York, with a severity of "Critical." Do not specify a component. Now refresh the /Locations "Map" tab. Notice that the New York dot has become red. Also notice that the link between New York and Los Angeles remains green.

  9. Now navigate to the New York device's "OS" tab and determine the id of the component that is connected to the network shared with the Los Angeles device. Send another test event, but this time specify that component. Now refresh the /Locations "Map" tab and notice that the line linking the two locations has become red.

5.2. Adding, Moving, and Nesting Locations

To create a new Location or Sub-Location:

  1. From the Navigation menu on the left, under Browse by, select Locations.

    The Sub-locations Status tab appears.

  2. Open the Sub-Locations table menu to show Sub-Locations options.

  3. Select the Add New Organizer option.

    The Add Organizer dialog appears.

  4. In the ID field, Enter the name for the new Sub-location.

  5. Click OK.

    The new sub-location is added and appears in the list.

5.2.1. Moving Sub-locations

To move the sub-location into another location or sub-location:

  1. Select the location from the location list by clicking the check box next to the locations that you want to move and then from the Sub-Locations table, select the Move Organizer option. The Move Organizer dialog appears.

  2. From the pop-up menu, select where you want to move this location.

  3. Click Move.

    The location is moved to the selected location and the attributes page for the location where you moved the location appears.