Manage Sites

Sites in Kentik are discussed in the following topics:

• About Sites
• Sites Page
• Site Admin Dialogs
• Site Markets Page
• Add or Edit a Site

Note: If you need assistance with any aspect of managing your sites, please contact Customer Support.

A site is a specific user-defined physical location (address), e.g. a data center, with which you can associate one or more devices. Once a site is created in Kentik, you can assign one or more devices to the site via the settings for those devices. Sites with common characteristics, such as all PoPs in a particular metropolitan area, can be grouped into a "site market."

The settings for sites and site markets are accessed via the Settings page (choose Settings from the main menu):

• Sites are managed on the Sites page: choose Manage Sites under Network Metadata on the Settings page.
• Sites markets are managed on the Site Markets page: choose Manage Site Markets under Network Metadata.

Notes:
- Kentik works best when all of your data sources are assigned to sites. Set the site property for each device via the Plan & Site tab of the Add Device or Edit Device dialog (see Device Plan & Site Settings).
- To view the devices assigned to a given site, see View Site Devices.

Sites are managed from the Sites page of the Kentik portal (Settings » Manage Sites), which is covered in the following topics:

• Sites Page UI
• Site List
• Site Filters
• View Site Devices

The Sites page includes the following UI elements:

• Filters toggle: Opens or closes the Filters pane.
• Group By: A drop-down from which you can choose how to group the sites in the list:
  - If the selected value in this control is Country, Type, or Market then the table will include a heading row for each instance of that value (e.g. each country with a site), followed by the rows of the sites that share that value (e.g. the sites in a given country).
  - If the selected value is None then sites are listed, without grouping, in the sort order determined by the currently selected column heading.
• Search field: Filters the Site List to show only rows that contain the entered text, either in one of the columns or in the Site Details card.
• Add Site button: Opens an Add Site dialog where you can add a new site (see Add a Site).
• Site List: A table listing your organization’s sites (see Site List).
• Filters pane: A set of checkboxes (in a sidebar at left) that enable you to filter the Site List by Type, Site Country, or Site Market (see Site Filters).

Note: Sites can also be added and edited with the Site API.

The Site list is a table that shows information about the listed sites. By default, the list is ordered alphabetically by name. To change the sort order of the list, click a heading to choose a column, and click the resulting blue up or down arrow to choose the sort direction (ascending or descending).

The Site list includes the following columns (left to right):

• Site: The site’s customer-assigned name string.
• Type: The type of the site (see Type in Site Field Definitions).
• City: The city in which the site is located.
• Region: The region in which the site is located.
• Country: The country in which the site is located.
• Site Market: The site market (if any) to which the site has been assigned.

The far-right column of the Site list includes icons that function as buttons for the following actions:

• Edit site: Opens an Edit Site dialog that allows you to review and edit the site’s settings (e.g. name, address, type, architecture, and site IP classification). See Site Admin Dialogs.
• Remove: Opens a confirming dialog that allows you to remove the site from your organization's collection of sites.

Note: The above actions are not available to Member-level users.

Click anywhere on a row of the Site list to open the details drawer from the right of the page. The details drawer for the site will include the following elements:

• Architecture: The user-defined architecture of the site. For more information about defining a site's architecture, see Architecture Edit UI.
• Address: The physical location of the site.
• View in Network Explorer button: Opens up the site’s details page (see Core Detail Pages) in Network Explorer.

The Filters pane to the left of the Site list allows you to filter the list to show only sites that match the criteria that you specify with the pane's checkboxes. If the pane is collapsed you can expand it with the Filters toggle (see Sites Page UI).

The Filters pane includes the following controls:

• Collapse (left arrow at upper right): Close the pane. The Sites list will expand to the left to fill in the resulting space.
• Type: The site’s type (see Type in Site Field Definitions).
• Site Country: The country in which the site is located.
• Site Market: The site market (if any) to which the site has been assigned.

The following rules apply to filter categories and criteria:

• Criteria are ORed (match any) within categories and ANDed (match all) between categories
• When criteria are selected in more than one category, a row is displayed only if it matches at least one of the selected criteria in all of the categories with criteria selected.
• When no criteria are selected for a category, the row may match any of the category's listed criteria.

To see the devices assigned to a given site:

1. On the Sites page, click the site’s row in the Site List, which shows a Site Details card.
2. In the card, click the View in Network Explorer button, which takes you to the site's details page (see Core Detail Pages).
3. In the Traffic View Table at the bottom of the page, click the Devices tab on the table, which lists this site's devices.

Adding or editing a site via the Kentik portal involves specifying settings in the fields of the site admin dialogs, which are covered in the following topics.

• About Site Dialogs
• Site Dialogs UI
• Site Field Definitions

Note: Sites can also be added and edited with the Site API.

The admin dialogs for sites are used to collect and display site information that is not only displayed in the UI but also determines how the traffic handled by the sites' devices is characterized for the analytics presented in various Kentik portal modules. The required information is entered into the fields of either of the following dialogs:

• Add Site: To register a new site with Kentik, open this dialog from the Add Site button on the Sites page (Settings » Sites).
• Edit Site: To edit an already registered site, open this dialog from the Edit icon at the right of that site's row in the Sites list.

Note: Both of the above dialogs include a button that opens the Edit Site Architecture dialog (see Architecture Edit UI), which is used to provide a meaningful on-premises topology view for the site.

The Add Site and Edit Site dialogs share the same layout and the following common UI elements:

• Close button: Click the X in the upper right corner to close the dialog. All elements will be restored to their values at the time the dialog was opened.
• Cancel button: Cancel the add site or edit site operation and exit the dialog. All elements will be restored to their values at the time the dialog was opened.
• Add Site button (Add Site dialog only): Save settings for the new site and exit the dialog.
• Save button (Edit Site dialog only): Save changes to site settings and exit the dialog.

The site admin dialogs contain the fields and controls shown in the table below.

This drop-down selector offers the following options related to associating a site with a site market:

• Manage Options: Takes you to the Site Markets page.
• Create New: Click to create a new site market. The drop-down will be replaced with a name field, an inactive Add button, and a Cancel button. When you enter a name, the Add button will become active. Click it to save the new site market.
• Existing site markets: Click a site market in the drop-down to associate the site with that market.

The Site Markets Page is covered in the following topics:

• About Site Markets
• Site Markets Page UI
• Site Market Settings
• Site Markets List

A site market is a logical grouping to which you can optionally assign sites with any common characteristic of your choosing, such as all PoPs in a particular metropolitan area. Site markets are created on the Site Markets page, but sites are assigned to markets in the Add Site or Edit Site dialog of the Sites page (see Site Admin Dialogs).

You can get to the Site Markets page from the following locations:

• From the Settings page, choose Manage Site Markets under Network Metadata.
• From the Add Site or Edit Site dialog, click the Site Market Selector and choose Manage Options.

The main elements of this page include the following:

• Add Site Market: A button that opens the Add Site Market dialog (see Site Market Settings).
• Search field: Filters the Site Markets list to show only rows that contain the entered text.
• Site Markets list: A list of existing Site Markets.

The settings for site markets are made in the following dialogs:

• Add Site Market: Create a new site market and specify its properties.
• Edit Site Market: Change the properties of an existing site market.

These dialogs both contain the following fields:

• Name (required): A unique name for the site market.
• Description: User-provided details about the site market, for example an explanation of what its sites have in common.

The Site Markets list is a table that shows information about the site markets in your organization. By default, the list is ordered alphabetically by the Name column. To sort by a different column, click that column's heading, then click the associated up or down arrow to choose the sort direction (ascending or descending).

The list includes the following columns:

• Name: The name of the site market.
• # of Sites: The total number of sites assigned to the site market.
• Description: A brief description of the site market, if provided.
• Created: The date that the site market was added.

The far-right column of the Site Markets list includes icons that function as buttons for the following actions:

• Edit: Opens the Edit Site Market dialog, where you can change the site market's properties (see Site Market Settings).
• Remove: Opens a confirming popup that enables you to remove the market from your organization's collection of site markets.

The adding and editing of sites is covered in the following topics:

• Add a Site
• Edit a Site

To add a new Site:

1. Choose Settings from the main menu, then Manage Sites (under Network Metadata).
2. Open the Add Site dialog by clicking the Add Site button at upper right.
3. Enter a name in the Name field.
4. Specify the values of the remaining fields (see Site Field Definitions).
5. Click the Add Site button to add the site.

Note: To add the site’s architecture, see Site Architecture.

To edit an existing site:

1. Choose Settings from the main menu, then Manage Sites (under Network Metadata).
2. In the Site List, click the edit site button in the row for the site you’d like to edit, which will open the Edit Site dialog.
3. Edit the fields that you want to change (see Site Field Definitions).
4. Click the Save button to save your changes.

Note: To edit site architecture, see Site Architecture.