Skip to content
Skills Library
DevOps & cloud · Analysis

te-path-analysis

/te-path-analysis

Cisco ThousandEyes — path visualization, BGP route analysis, outage investigation, instant tests, endpoint agent diagnostics. Requires ThousandEyes endpoint/enterprise agents already deployed. Use when tracing network paths hop-by-hop, investigating why a site is slow, analyzing BGP route changes, diagnosing an internet outage, or troubleshooting VPN from endpoint agents. If ThousandEyes is not deployed, use `gtrace-path-analysis` for ad-hoc traceroute/MTR/GlobalPing from this host instead.

Repository
netclaw ↗
Licence
Apache-2.0
Last repository change
25.10.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Cisco ThousandEyes — path visualization, BGP route analysis, outage investigation, instant tests, endpoint agent diagnostics. Requires ThousandEyes endpoint/enterprise agents already deployed. Use when tracing network paths hop-by-hop, investigating why a site is slow, analyzing BGP route changes, diagnosing an internet outage, or troubleshooting VPN from endpoint agents. If ThousandEyes is not deployed, use `gtrace-path-analysis` for ad-hoc traceroute/MTR/GlobalPing from this host instead.

Original author description

Cisco ThousandEyes — path visualization, BGP route analysis, outage investigation, instant tests, endpoint agent diagnostics. Requires ThousandEyes endpoint/enterprise agents already deployed. Use when tracing network paths hop-by-hop, investigating why a site is slow, analyzing BGP route changes, diagnosing an internet outage, or troubleshooting VPN from endpoint agents. If ThousandEyes is not deployed, use `gtrace-path-analysis` for ad-hoc traceroute/MTR/GlobalPing from this host instead.

How it works

  1. MCP Servers
  2. Key Capabilities
  3. Workflow: "Why Is Site X Slow?"
  4. Workflow: Internet Outage Triage
  5. Workflow: Endpoint VPN Troubleshooting
  6. Workflow: BGP Hijack / Leak Detection
  7. Integration with Other Skills
  8. Important Rules
  9. Environment Variables
  10. Failure Behavior
Original SKILL.md headings · 140 lines, 1,118 words
SKILL.md preview
---
name: te-path-analysis
description: "Cisco ThousandEyes — path visualization, BGP route analysis, outage investigation, instant tests, endpoint agent diagnostics. Requires ThousandEyes endpoint/enterprise agents already deployed. Use when tracing network paths hop-by-hop, investigating why a site is slow, analyzing BGP route changes, diagnosing an internet outage, or troubleshooting VPN from endpoint agents. If ThousandEyes is not deployed, use `gtrace-path-analysis` for ad-hoc traceroute/MTR/GlobalPing from this host instead."
version: 1.0.0
license: Apache-2.0
tags: [cisco, thousandeyes, path-vis, bgp, outage, instant-test, endpoint, troubleshooting]
---

# ThousandEyes Path Analysis & Troubleshooting

## MCP Servers

- **Community**: `src/server.py` (stdio, Python 3.12+) — `te_get_path_vis` for path visualization
- **Official**: `https://api.thousandeyes.com/mcp` (remote HTTP) — full path vis, BGP, instant tests, anomalies, endpoint agents

## Key Capabilities

### Path Visualization

| Source | Tool | What It Does |
|--------|------|--------------|
| Community | `te_get_path_vis` | Hop-by-hop path from a specific agent to the test target |
| Official | Get Path Visualization | Network paths with routing details |
| Official | Get Full Path Visualization | Comprehensive path data aggregated across all agents |

Path visualization shows every network hop between agent and target:
- **IP address** and **DNS name** of each hop
- **Latency** per hop (pinpoints where delay is introduced)
- **Packet loss** per hop (identifies lossy links)
- **MPLS labels** (reveals traffic engineering paths)
- **Network owner** (ISP/carrier identification per hop)

### BGP Route Analysis

| Tool | What It Does |
|------|--------------|
| Get BGP Test Results | BGP reachability — which BGP monitors see the prefix, which don't |
| Get BGP Route Details | AS path, origin AS, prefix length, route stability |

BGP analysis provides external routing visibility:
- **Prefix reachability** from ThousandEyes' global BGP monitor fleet
- **AS path** — is traffic routing through expected carriers?
- **Route changes** — detect BGP hijacks, leaks, or suboptimal routing
- **Origin validation** — verify the prefix originates from the correct AS

### Outage Investigation

| Tool | What It Does |
|------|--------------|
| Search Outages | Find network and application outages with time/scope filters |
| List Events | Network/application problems with affected targets |
| Get Event Details | Deep dive: impacted tests, affected agents, timeline |

### Active Troubleshooting

| Tool | What It Does |
|------|--------------|
| Instant Tests | Run tests on demand from selected agents — don't wait for scheduled cycles |
| Get Anomalies | Detect metric deviations from baseline over time |
| Views Explanations | AI-powered explanation of test results and visualizations |

### Endpoint Diagnostics

| Tool | What It Does |
|------|--------------|
| List Endpoint Agents and Tests | Endpoint agents on user workstations with test associations |
| Get Endpoint Agent Metrics | WiFi signal, VPN tunnel latency, DNS response, HTTP performance |

## Workflow: "Why Is Site X Slow?"

The classic ThousandEyes troubleshooting workflow:

1. **Identify test**: `te_list_tests` (community) filtered by target site
2. **Check results**: `te_get_test_results` (community) — is latency elevated? Packet loss?
3. **Path visualization**: `te_get_path_vis` (community) — hop-by-hop analysis
4. **Full path**: Get Full Path Visualization (official) — all agents, compare paths
5. **Pinpoint hop**: identify the hop where latency spikes or loss appears
6. **BGP check**: Get BGP Route Details (official) — is routing suboptimal?
7. **Anomalies**: Get Anomalies (official) — when did the degradation start?
8. **Report**: "Latency increase traced to hop 7 (ISP-X backbone router 203.0.113.45). AS path changed at 14:32 UTC — traffic now routing through AS 64512 instead of direct peering. BGP route via AS 65001 withdrawn."

## Workflow: Internet Outage Triage

When ThousandEyes detects a broad outage:

1. **Search outages**: Search Outages (official) — scope: ISP, CDN, SaaS provider?
2. **Events**: List Events (official) — which tests are affected?
3. **Event details**: Get Event Details (official) — impacted targets, severity, timeline
4. **Path vis**: `te_get_path_vis` (community) for affected tests — where does the path break?
5. **BGP**: Get BGP Test Results (official) — prefix still reachable? Route withdrawn?
6. **Instant test**: Instant Tests (official) — verify from multiple cloud agents
7. **Report**: outage scope, affected services, root cause, estimated provider recovery

## Workflow: Endpoint VPN Troubleshooting

When users report VPN issues:

1. **List endpoint agents**: List Endpoint Agents and Tests (official) — affected users
2. **Endpoint metrics**: Get Endpoint Agent Metrics (official) — WiFi signal, DNS, VPN latency
3. **Path visualization**: Get Path Visualization (official) — user to VPN gateway path
4. **Compare**: run enterprise agent test to same VPN gateway — is it user-side?
5. **Anomalies**: Get Anomalies (official) — when did metrics degrade?
6. **Report**: "User WiFi signal -72 dBm (poor), DNS response 450ms (ISP DNS slow). VPN tunnel latency 180ms due to WiFi retransmissions. Recommend: switch to 5 GHz band, use corporate DNS."

## Workflow: BGP Hijack / Leak Detection

When validating BGP route security:

1. **BGP tests**: `te_list_tests` (community) filtered by BGP test type
2. **BGP results**: Get BGP Test Results (official) — reachability from global monitors
3. **Route details**: Get BGP Route Details (official) — AS paths from all vantage points
4. **Anomalies**: unexpected AS in path? Prefix originated from wrong AS?
5. **Path vis**: Get Full Path Visualization (official) — confirm traffic follows expected path
6. **Cross-reference**: `pyats-routing` for internal BGP state confirmation
7. **Report**: BGP security assessment with route origin validation

## Integration with Other Skills

| Skill | How They Work Together |
|-------|----------------------|
| `te-network-monitoring` | Monitoring provides context (tests, dashboards), path analysis provides deep investigation |
| `pyats-routing` | ThousandEyes external BGP + pyATS internal BGP = complete routing picture |
| `pyats-troubleshoot` | ThousandEyes internet path + pyATS device-level CLI diagnostics |
| `meraki-security-appliance` | ThousandEyes path through MX + Meraki VPN status for SD-WAN troubleshooting |
| `aws-network-ops` | ThousandEyes cloud agent + AWS VPC flow logs for hybrid path analysis |
| `fmc-firewall-ops` | ThousandEyes path vis shows traffic traversing FTD + FMC rule analysis |
| `servicenow-change-workflow` | Outage events trigger ServiceNow incidents with ThousandEyes evidence |
| `gait-session-tracking` | Record all path analysis and troubleshooting in GAIT |

## Important Rules

- **Instant Tests consume test units** — use judiciously; each run counts against your ThousandEyes license
- **Path visualization requires network layer tests** — HTTP server tests won't show full path data
- **BGP monitors are global** — ThousandEyes has 300+ BGP vantage points; results reflect internet-wide routing
- **Endpoint agents need permission** — endpoint data is privacy-sensitive; respect data governance
- **Time ranges matter** — narrow queries to the incident window to reduce API load and improve relevance
- **Record in GAIT** — log all path analysis, outage investigations, and BGP findings

## Environment Variables

- `TE_TOKEN` — ThousandEyes API v7 OAuth bearer token (shared with te-network-monitoring)

## Failure Behavior

- On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
- For a confirmed read-only call, check connectivity and retry once if appropriate. For any call that changes state or sends a message, a timeout does not prove the action failed: inspect current state or delivery status before retrying, preserve the required approval/change gates, and do not repeat an action whose outcome is unknown.

Versions

The database has no other skills named te-path-analysis.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version e175f1b4e3f7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100gtrace-path-analysis
    Network path tracing and monitoring — traceroute with MPLS/ECMP/NAT detection, continuous MTR monitoring, and distributed GlobalPing probes from 500+ worldwide locations. Use when tracing the path to a destination, diagnosing slow network routes, detecting MPLS or ECMP load…
  • 100thousandeyes
    Expert coverage of Cisco ThousandEyes synthetic monitoring and internet intelligence platform: Cloud/Enterprise/Endpoint agent types, test types, path visualization, Internet Insights outage detection, Cisco SD-WAN integration, BGP monitoring, and API automation. Use for…
  • 100te-network-monitoring
    Cisco ThousandEyes — test management, agent inventory, test results, dashboards, path visualization, user/account management. Use when checking ThousandEyes test results, viewing network monitoring dashboards, listing agents, investigating alerts, or assessing overall network performance.
  • 100network-bgp-diagnostics
    Diagnostics-only BGP troubleshooting patterns for neighbor state, route exchange, prefix policy, AS path inspection, and safe evidence collection. Use when a BGP neighbor is down, routes are missing, or prefix policy and AS path need inspection.
  • 100network-bgp-diagnostics
    Diagnostics-only BGP troubleshooting patterns for neighbor state, route exchange, prefix policy, AS path inspection, and safe evidence collection. Use when a BGP neighbor is down, routes are missing, or prefix policy and AS path need inspection.
  • 100routing-protocols-bgp-ospf-fundamentals
    Use this skill when analyzing interior gateway OSPF path selection and exterior BGP autonomous system peering on enterprise networks.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.