# Network Outages

{% hint style="warning" %}
Due to recent platform-wide naming, navigation, and URL changes in the product, you may notice some discrepancies between the product and the screenshots displayed in our technical documentation. The instructions and actual pages in the product are still valid and haven’t changed. Please bear with us as we update our screenshots to better match the in-product experience. See the full scope of changes on [Naming and Navigation Menu changes - Summary List](https://docs.thousandeyes.com/whats-new/naming-and-nav-phase-2-changes).
{% endhint %}

Network outage events represent a series of events that affect a large number of terminal interfaces and associated Network metrics at one or more points of presence of a given service provider (ASN).

## Network Outages View Timeline

On the **Internet Insights > Service Views** screen, the top portion shows a timeline, as shown in the image below. (Network Outages displays by default.)

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-098d7f26b6aaafa747d37f60a4e03e359f4ba03b%2Finternet-insights-002-timeline-network-outages.png?alt=media\&token=2db0bcb8-d27e-435b-89a6-795cb3c0c11f)

## Network Outages Timeline Filters

The **Network Outages** timeline at the top of the view screen lets you filter or display data as follows:

* **Metric**: Affected Tests, Interfaces, Locations, or Outages
* **Outage Scope** is All or With Affected Tests, meaning you can limit application outages to only show those affecting your own tests.
* The **Network** filter lets you search for and choose one or more networks by name or Autonomous System (AS) number, for example IP-Max Network Services (AS 25091).

Click **Add a filter** to add filters including:

* **Outage** filters
  * **Outage Scope** - same filter that’s already displayed
  * **Affected Provider** - choose by provider type (e.g., CDN), region, or by name
* **Network** filters
  * **Network** - same filter that’s already displayed
  * **Interface Location** - choose by region, country, or city
  * **Interface IP Address** - use the search box to narrow down the long list of numeric IP addresses
* **Application** filters
  * **Affected Test** - these are tests potentially impacted by the outage, as described in [My Affected Tests](https://docs.thousandeyes.com/product-documentation/internet-insights/using-alerts-and-dashboards-with-internet-insights/my-affected-tests)
  * **Affected Hostname/Domain** - quickly search for a domain like “google.com” or a hostname like “myserver.domain.com”
  * **Server Location** - search by region, country, or city
  * **Server Prefix** - use to find a server with a particular IP prefix
  * **Server Network** - use to find by Autonomous System (AS) number or name, for example InterVoice, Inc. (AS 393222)

## Network Outages Map Tab

When you've selected a timeslice in the timeline, the **Internet Insights > Service Views > Map** tab shows a map of the outage(s) along with summarized outage information.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-b796c9750b385556e7e68f07f835c602694a4d7b%2Finternet-insights-002a-network-outages-map-tab.png?alt=media\&token=300c17d5-7311-4592-b897-9df2496d0762)

## Network Outages Topology Tab

The **Internet Insights** > **Service Views** > **Topology** tab displays different information, depending on whether you have **Network Outages** or **Application Outages** selected as the view at the top of the screen.

If you have the **Network Outages** view selected, you’ll see a path visualization similar to the one shown below.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-0d351eee153506a7fdc9a561e356a37dd7049b2d%2Finternet-insights-003-topology-network-view.png?alt=media\&token=1ba0989d-5c06-4373-9caf-62a7f2a690e8)

The Internet Insights Network Outages topology view uses nodes to represent the status of network Points of Presence (PoPs) and the impact on interconnected networks. These nodes represent networks or locations, with sources on the left and targets on the right.

### Legend

| **Object Image**                                                                                                                                                                                                                                                                                                   | **What it signifies**                                                                                                                                                                                             | **Comments**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![Blue Node](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-188b0be9c18eb096db970077c7bfc6be60fd44b7%2Finternet-insights-blue-node.png?alt=media\&token=8ebac2ae-8601-490d-9fc9-b39fc2808b88)                                    | Identifiable node                                                                                                                                                                                                 | A blue node indicates that IP information is available.                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ![Green Node](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-f6f4e23e742535f3f9a1149efc572de1c1337c53%2Finternet-insights-green-node.png?alt=media\&token=c753c465-e7ae-4be2-a661-192fd2c4e78c)                                  | Node in agent’s network                                                                                                                                                                                           | A green node indicates a node that was identified as inside the source network, as specified by the Autonomous System of the Agent.                                                                                                                                                                                                                                                                                                                                                                                        |
| ![Red Node](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-4fbfe41a2a9b0ace6b40aa02f0d37fe7833dc3fe%2Finternet-insights-red-node.png?alt=media\&token=0d987ee3-c2a9-4462-835a-c42aa14f9d41)                                      | Network PoPs where outages are occurring or have occurred                                                                                                                                                         | <p>A red node signifies Network PoPs where outages are occurring or have occurred, depending on the selected timeline. When hovering over a red node, the tooltip displays the following information related to the outage:</p><ul><li>Duration of the outage</li><li>Number of interfaces impacted</li><li>Locations of the outage</li><li>IP addresses and prefixes</li><li>Networks affected by this outage</li><li>List of affected tests</li><li>ThousandEyes visibility, percentage of all tests affected.</li></ul> |
| ![Yellow Node](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-6a553b3759bad125c415dfd1346a059b9b62ab6d%2Finternet-insights-yellow-node.png?alt=media\&token=d1833643-a769-428e-ada4-6146f7416f54)                                | A yellow node indicates other networks directly affected by the outage, located upstream from the red nodes. Yellow nodes are identified through test failures that pinpoint the source of the outage (red node). | <p>When hovering over a yellow node, the tooltip displays the following information:</p><ul><li>Affected duration</li><li>Number of interfaces impacted</li><li>IP address and prefix</li><li>Outage network</li><li>Time outage was detected</li><li>Outage location</li><li>Outage IP addresses</li><li>Outage prefixes</li></ul>                                                                                                                                                                                        |
| ![White Node](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-93e88499bf0a7eeed71871f5c6b93e1d43789031%2Finternet-insights-white-node.png?alt=media\&token=51ece2d1-1ba1-4dbe-8aa5-091dc3971155)                                  | Unidentifiable node                                                                                                                                                                                               | A white node indicates that IP information is not available.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ![Red dotted lines with exclamation mark](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-c4abaa9732747e8d5aa53120e875fd465b268deb%2Finternet-insights-red-dotted-line.png?alt=media\&token=a3b8e5a4-da36-4ae0-b433-8bd2606e2875) | Affected network path                                                                                                                                                                                             | This indicates a network path issue, which might involve a problem with the link between the affected node and the node where the outages are occurring or have occurred.                                                                                                                                                                                                                                                                                                                                                  |
| ![Grey dotted lines with X](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-5383ed35180a8eb079dd5b025e6c53545684870c%2Finternet-insights-grey-dotted-line.png?alt=media\&token=a61083e1-e8d6-4a2b-8e52-dee7da2bf360)              | Network path previously reachable but now unreachable                                                                                                                                                             | These represent a network path that was previously reachable but have since become unreachable.                                                                                                                                                                                                                                                                                                                                                                                                                            |

### Tooltips and Additional Information

The tooltips in the Network Outage Topology Interface provide access to detailed outage information.

![Red Node Tooltip](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-9c3a40dd8e485adc3ff6cdeadb0aeba283c2972d%2Finternet-insights-red-node-tooltip.png?alt=media\&token=8b9b5764-cfcf-47f0-b25e-49f63964b8a6)

![Yellow Node Tooltip](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-e3c5fdc73890c50fd374471b50e47c62d97cc4b0%2Finternet-insights-yellow-node-tooltip.png?alt=media\&token=c5e58073-d967-4112-aeae-d34dc4296cd5)

* **Outage Duration**: Elapsed time since the outage began.
* **Outage Detected**: The time from `roundId` when the outage was detected.
* **Interfaces Impacted**: Details the specific network interfaces affected by the outage.
* **Outage Location**: The geographic location of the outage, providing context for regional issues.
* **IP Address**: The specific IP address associated with the outage.
* **Prefix**: Network prefix associated with the affected IP.
* **Networks Impacted**: Names and ASNs of the networks affected by the outage, including those indirectly affected (represented by yellow nodes).
* **Affected Tests**: URLs of tests that are being impacted by the network outage.
* **ThousandEyes Visibility**: Indicates the percentage of all tests affected by the outage. The "ThousandEyes Visibility" is calculated as follows:

  * **For a Node Group:** TE visibility = (Number of failed tests for all nodes in the node group / Total number of tests for all nodes in the node group) \* 100.
  * **For a Single Node:** TE visibility = (Number of failed tests for the single node / Total number of tests for the single node) \* 100.

  The total number of tests for all nodes in a node group is equivalent to the total number of tests for that ASN. The ASN is the same for all nodes within a given node group.
* **Outage Network**: The network provider experiencing the outage.
* **Outage IP Address**: The IP address where the outage is detected.
* **Outage Prefix**: The subnet information associated with the outage.

### Navigating the Topology

To navigate the topology and interpret the data:

* First, ensure an outage was selected from timeline at the top of the page
* Select a Node: Hover on any node to bring up the tooltip with detailed information.
* Trace the Path: Follow the lines connecting the nodes to understand the path of the outage's impact.
* Examine Timelines: Use the timeline feature to review the progression of the outage over time.
* By default, sources are displayed as aggregated by country. IP and domain are not displayed. The number of agents is tabulated in the menu that appears when you hover over the source node.
* By default, intermediate nodes are aggregated by Autonomous System (AS) number.
  * The menu that appears when you hover over the node shows the number of affected destinations and provides a link that shows the list of affected tests in a pop-up window.
  * Affected ASes are determined from public rDNS on the target IP and not target domain.
* By default, only links with 0% of traces are shown.
* Targets show the AS number and the number of affected interfaces in the view. The tooltip that appears when you hover over the node will show the number of affected destinations and provide a link that will show the list of affected tests in a pop-up window. Another link is available that shows only outages affecting the destinations relevant to that node.
* Click **Next nodes** (if available) to see more nodes impacted by an outage event.

### Network Outages Topology and Grouping Filters

The **Topology** tab includes **Showing** (i.e., filtering) and **Grouping** options to highlight aspects of the topology visualization, as shown below.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-bd1215b0ec0815a83e8d58da49c100a01dbc3c18%2Finternet-insights-004-filters-topology-network.png?alt=media\&token=0ecaf670-ccc2-421f-8990-de5cee6777dc)

Nodes with outages are tallied under **Highlighting**. You can narrow the highlighting using the field **Highlight nodes that match all / any** and then choosing a list item such as Test name, Location, IP address, Prefix, or Domain. For example, if you choose Domain, a list of affected domains appears, and you can select one of those to highlight only those affected nodes on the path visualization.

**Showing** lists any currently applied filters. Click **Add a filter** to add multiple filters with these options:

* **Agents** filters - These are ThousandEyes cloud or your own ThousandEyes enterprise agents.
  * **Agent Country**
  * **Agent Origin Network**
  * **Agent Next Hop Network**
  * **Agent Location** (city)
  * **Agent**
* **Network** filters
  * **Network**
  * **Interface Location**
  * **Network & Location**
  * **Interface IP Address**
  * **Application** shows applications currently impacted by the outage selected in the timeline above
  * **Affected Test** - these are tests potentially impacted by the outage, as described in [My Affected Tests](https://docs.thousandeyes.com/product-documentation/internet-insights/using-alerts-and-dashboards-with-internet-insights/my-affected-tests)
  * **Hostname/Domain** - quickly search for a domain like “google.com” or a hostname like “myserver.domain.com”
  * **Server Prefix** - use to find a server with a particular IP prefix
  * **Server Network** - find by Autonomous System (AS) number or name
  * **Server Location** - search by region, country, or city
  * **Outage** - search by outage event
* **Grouping** filters
  * **Agents by**: Country, Origin, Location, Agent
  * **Destinations by**: Application, Server Network, Server Location, Server Prefix, Domain

## Network Outages Table Tab

When you've selected a timeslice in the timeline, the **Internet Insights > Service Views > Table** tab shows information about the outage(s) in table form. Click a network name to open details about the outage.

![](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-bcf352209f622ede213bbb889c1fcac02ff12f32%2Finternet-insights-002b-network-outages-table-tab.png?alt=media\&token=17a9d49a-43ab-4100-bcae-15baf985c717)
