Network command search

Network / Transport / Circuits

Practical troubleshooting for network, transport, and carrier handoff circuits.

Route faults fast across DIA, Ethernet/L2, VLAN handoff, T1/DS1/PRI, SIP trunks, PON, and optical transport while keeping demarc ownership and change control explicit.

Network / Transport / Circuit lanes

Choose the right isolation lane before deep triage.

Start with demarc and service-boundary clarity, then jump directly to the flow lane that matches what you can verify on site right now.

Ethernet and VLAN state

Check interface status, tagging intent, and edge-side L2 behavior before escalation.

Jump to interface-flap lane

Critical escalation routes

  1. No handoff carrier sync → route to VLAN/handoff or circuit-down flow.
  2. Uncertain demarc ownership → route to boundary-verification flow before intrusive tests.
  3. Persistent packet loss beyond local edge → route to upstream reachability flow.
  4. Optical-path uncertainty → route to optics and transport continuity flow.
  5. Repeated interface flapping → route to port-state and L2 stability flow.
  6. Service-layer symptoms with clean physical state → route to SIP/IP service behavior flow.

Network / Transport / Circuits index

Open the correct isolation workflow fast.

Use this index to jump directly to the matching decision flow for DIA, Ethernet, VLAN, voice, optical transport, and circuit-quality faults. Keep findings tied to documented expectations and current service records.

Network / Transport / Circuits

Controlled testing and fault isolation guidance

Use this as a field-safe reference for diagnostics across DIA, Ethernet/L2, VLAN handoff, T1/DS1/PRI, SIP trunking, PON/GPON/XGS-PON, and optical transport contexts without introducing avoidable service impact.

Controlled-testing safety

Do not introduce service-impacting loopbacks, flap production interfaces, change live optics, move patching, or alter provisioning/VLAN state without verification and approved change control.

Before intrusive testing, confirm customer vs carrier boundaries, maintenance window status, and service ownership. If ownership is unclear, stop and escalate for boundary confirmation first.

Ping and traceroute

Best used for: Reachability checks and rough path visibility between endpoints or toward a handoff gateway.

What it can confirm: Basic continuity, latency variation trends, and visible path change points.

What it cannot confirm alone: Root-cause at Layer 1/2, policy filtering location, or whether intermediate nodes suppress control-plane responses.

Good practice: Test from more than one vantage point, log source/destination/time, and compare with expected routing design.

Escalate when: Path breaks cross carrier domains, route asymmetry is suspected, or local and remote tests conflict. Engage transport/carrier and local network teams.

Interface counters and light/status inspection

Best used for: Determining whether faults lean physical (signal/link) or logical (config/service state).

What it can confirm: Link transitions, error/discard trends, and alarm presence at the observed interface.

What it cannot confirm alone: End-to-end service behavior beyond that interface or ownership of upstream faults.

Good practice: Capture before/after snapshots with timestamps and correlate to incidents or maintenance windows.

Escalate when: Alarms persist across demarc with no local change or when optic alarms require provider visibility. Engage optical, carrier, and local network teams.

VLAN and handoff verification

Best used for: Validating tag expectations, encapsulation alignment, and demarc handoff assumptions.

What it can confirm: Whether observed handoff behavior matches intended service presentation.

What it cannot confirm alone: Carrier-side provisioning correctness or end-to-end policy/QoS intent across domains.

Good practice: Verify documented handoff type first, then compare both sides of demarc before proposing changes.

Escalate when: Encapsulation ownership is ambiguous or customer/carrier expectations differ. Engage carrier transport and local network teams.

Loopbacks and sectionalization planning

Best used for: Dividing long paths into controllable segments to isolate fault zones logically.

What it can confirm: Which section passes or fails under controlled conditions.

What it cannot confirm alone: That production impact is acceptable without approved window and ownership alignment.

Good practice: Pre-approve method, rollback, and communications path before any intrusive loopback action.

Escalate when: Loopback authority, scope, or blast radius is uncertain. Engage change control, carrier transport, and site operations teams.

BERT and T-BERD style testing

Best used for: Structured integrity testing on agreed segments for transport/circuit troubleshooting.

What it can confirm: Whether a tested segment can pass a defined pattern test under current conditions.

What it cannot confirm alone: Application-layer behavior, routing policy health, or customer-side service readiness.

Good practice: Align pattern/test direction/timebox with all parties and log exact test boundaries.

Escalate when: Results disagree across endpoints or require provider-side interpretation. Engage transport carrier teams and, for voice circuits, voice operations.

OTDR and optical-path inspection

Best used for: Identifying likely optical event zones and continuity issues on fiber paths.

What it can confirm: Relative location of reflective/non-reflective events and segment continuity characteristics.

What it cannot confirm alone: Live service quality from all protocols or exact remediation ownership across shared plant.

Good practice: Coordinate directionality, reference points, and demarc endpoints before interpreting traces.

Escalate when: Event ownership crosses outside plant, building backbone, or carrier span. Engage optical/fiber plant and carrier teams.

Power meter usage and optics handling

Best used for: Baseline optical presence checks and clean-handling workflow validation.

What it can confirm: Whether optical signal is present and whether handling/cleaning workflow changed observed behavior.

What it cannot confirm alone: End-to-end service assurance, protocol integrity, or provisioning correctness.

Good practice: Follow approved cleaning/inspection procedure, avoid unnecessary live optic swaps, and record connector path details.

Escalate when: Optic compatibility, handling limits, or interpretation requires deeper guidance. Engage optical specialists and manufacturer/carrier references.

Logical service review (PRI / SIP / PON / transport)

Best used for: Matching signaling/session/provisioning intent with observed behavior across service layers.

What it can confirm: Whether service definitions and handoff expectations are logically aligned.

What it cannot confirm alone: Physical-layer integrity of every segment or provider-side policy implementation details.

Good practice: Correlate alarms, call/session symptoms, and transport path notes before declaring a single-point fault.

Escalate when: Symptoms span signaling and transport boundaries. Engage voice, PON/optical, transport/carrier, and local network teams as applicable.

Terminology and demarcation alignment

Layer 1 isolation: Physical medium, connectors, optics, and signal continuity checks.

Layer 2 isolation: Framing, VLAN/tag behavior, handoff encapsulation, and interface state consistency.

Layer 3 isolation: Addressing, route reachability, and path behavior between expected endpoints.

Customer vs carrier demarc: Define where ownership changes before assigning fault responsibility.

Logical vs physical faults: Logical misalignment can exist with clean optics; physical impairment can exist with valid configs.

Handoff and sectionalization: Use clear handoff definition and segmented tests to avoid false isolation conclusions.

Why documentation matters: Incomplete notes create false isolation, duplicate work, and delayed ownership handoff across teams.

Documentation and escalation handoff

  • Record: service identifier, circuit ID, demarc location, and handoff type.
  • Record: optics/interface notes, timestamps, observed alarms/counters, and trace path evidence.
  • Assign: who owns the next action (carrier, transport, voice, optical/fiber, or local network team).
  • Refer: carrier/site/manufacturer documentation whenever interpretation exceeds local scope.

Network / Transport / Circuits

Decision flows for rapid isolation

Use these client-side guides to isolate Layer 1 through Layer 3 faults without uncontrolled service impact. Document each checkpoint, separate logical versus physical isolation, and escalate with evidence.

Legend

  • Step order: Symptom → Safety → Checks → Test → Expected Result → Decision → Action → Resolution.
  • Decision controls: select one full-width outcome button to reveal the matching Action and Resolution panels.
  • Controlled testing only: do not introduce loopbacks, move optics, repatch circuits, alter live VLAN/service state, or clear/disable live interfaces without verification and approved change control.
  • Thresholds/behavior: compare optic power, BER trends, and service logic against circuit records, local standards, and carrier/manufacturer documentation.

Coming soon (backend required)

Save flow state History timeline Share handoff bundle

Guide 1

DIA and circuit down

Includes: full outage, handoff no-light/no-carrier, local edge up but path uncertain, demarc continuity checks.

Expand
  1. Symptom

    DIA/circuit reported down, or customer reports complete service loss.

  2. Safety

    No repatch, no optic move, no loopback insertion, and no interface shutdown/no-shut without verification and active change control.

  3. Checks

    Confirm alarm time, demarc ownership, power/LOS state at CPE and NID, local interface admin/oper status, and recent planned works.

  4. Test

    Perform non-intrusive sectionalization: local edge counters/status, demarc light/carrier presence, and upstream reachability from approved probes.

  5. Expected Result

    Either no link at handoff, or local interface up with uncertain service path continuation.

  6. Decision

  7. Action

  8. Resolution

Guide 2

Ethernet and Layer 2 service faults

Includes: MAC learning gaps, handoff mismatch, broadcast/unknown-unicast symptoms, L2 continuity uncertainty.

Expand
  1. Symptom

    Service unstable or unreachable over Ethernet handoff though physical carrier may be present.

  2. Safety

    Do not clear MAC tables, disable trunks, or alter spanning/live forwarding state without coordinated maintenance window.

  3. Checks

    Review interface mode, encapsulation, MTU alignment, MAC learning behavior, and storm/error indicators.

  4. Test

    Run safe L2 adjacency tests and controlled traffic observation from approved test endpoint.

  5. Expected Result

    Either local switching inconsistency appears, or local L2 looks healthy but path continuity still uncertain.

  6. Decision

  7. Action

  8. Resolution

Guide 3

VLAN verification and handoff issues

Includes: VLAN mismatch not ruled out, tag/untag confusion, QinQ expectations, demarc handoff policy mismatch.

Expand
  1. Symptom

    Traffic absent/intermittent on expected VLAN handoff.

  2. Safety

    Do not modify active VLAN membership or trunk pruning without verification and approved rollback path.

  3. Checks

    Confirm service order identifiers, VLAN IDs, tag handling, native VLAN policy, and customer handoff expectation.

  4. Test

    Observe tagged frames at approved points and verify expected encapsulation continuity.

  5. Expected Result

    Either local tagging mismatch is evident, or VLAN path remains uncertain beyond local edge.

  6. Decision

  7. Action

  8. Resolution

Guide 4

T1/DS1 and PRI faults

Includes: LOS/LOF alarms, framing/line-code concerns, slip/BER trends, PRI signaling and call setup failures.

Expand
  1. Symptom

    T1/DS1/PRI service degraded, down, or call setup incomplete.

  2. Safety

    No intrusive loopback insertion unless authorized test window and remote coordination are active.

  3. Checks

    Verify framing, line code, clock source alignment, alarm set, and PRI layer status against circuit records.

  4. Test

    Run non-disruptive status/BER observation and signaling trace review using approved tools.

  5. Expected Result

    Find either local config/alarm inconsistency or provider-side continuation indicators.

  6. Decision

  7. Action

  8. Resolution

Guide 5

SIP trunk service faults

Includes: registration/session setup, signaling present but media incomplete, one-way audio, policy and routing uncertainty.

Expand
  1. Symptom

    SIP signaling present but service behavior incomplete (failed calls, partial media, routing anomalies).

  2. Safety

    Do not alter live dial plans, trunk policy, or SBC security settings without approved change and rollback.

  3. Checks

    Validate trunk state, auth/policy profile, signaling responses, and media path prerequisites.

  4. Test

    Run controlled call tests and trace signaling/media at local edge and SBC boundary.

  5. Expected Result

    Either local voice policy issue appears, or upstream provider behavior remains suspect.

  6. Decision

  7. Action

  8. Resolution

Guide 6

PON, GPON, and XGS-PON issues

Includes: OLT/ONT status mismatch, optical path suspect, provisioning-state uncertainty, split-path continuity concerns.

Expand
  1. Symptom

    ONT/ONU unavailable, partial service, or unstable sessions on PON access.

  2. Safety

    Do not move optics or repatch splitters/live fibers without verified work authorization and optical safety controls.

  3. Checks

    Confirm OLT port state, ONT registration/profile, physical path labeling, and recent maintenance records.

  4. Test

    Use non-disruptive visibility tests and compare optical observations with documented ranges from carrier/manufacturer guidance.

  5. Expected Result

    Determine if provisioning/policy mismatch exists or if optical path continuity is suspect.

  6. Decision

  7. Action

  8. Resolution

Guide 7

CWDM and DWDM transport or optics issues

Includes: wavelength path concerns, optical alarms, BER trend concern, transponder/channel continuity uncertainty.

Expand
  1. Symptom

    Transport service degraded/down with optics or wavelength path suspicion.

  2. Safety

    No optic swap/move on live links without optical team approval, labeling verification, and change control.

  3. Checks

    Verify channel assignment, optical alarms, transponder/client interfaces, and documented expected behavior.

  4. Test

    Collect non-intrusive optical telemetry/BER trend and compare only to approved circuit and manufacturer references.

  5. Expected Result

    Differentiate local client-edge issue versus optical transport-path continuation.

  6. Decision

  7. Action

  8. Resolution

Guide 8

Packet loss and latency

Includes: intermittent loss, sustained latency growth, jitter concerns, path continuation beyond local edge.

Expand
  1. Symptom

    Packet loss or latency spikes affect application/service quality.

  2. Safety

    Do not clear live interfaces or alter QoS/service policies blindly; verify impact domain first.

  3. Checks

    Correlate incident time with interface counters, queue drops, path changes, and maintenance events.

  4. Test

    Run controlled bidirectional probes from local edge and compare near-end versus far-end behavior.

  5. Expected Result

    Either impairment localizes near edge, or loss persists beyond local edge indicating continuation.

  6. Decision

  7. Action

  8. Resolution

Guide 9

Errors and flapping

Includes: CRC/error growth observed, intermittent link transitions, unstable optics/electrical behavior, bursty impairment.

Expand
  1. Symptom

    Counters grow rapidly or interface flaps without sustained stable interval.

  2. Safety

    Avoid repeated reset/clear actions on live interfaces without confirming root-cause direction.

  3. Checks

    Track error type patterns, flap timestamps, optic/port telemetry, and environmental/cabling context.

  4. Test

    Observe error progression over controlled window; compare with known-good peer side behavior.

  5. Expected Result

    Isolate recurring pattern to local medium/device or continuation toward provider side.

  6. Decision

  7. Action

  8. Resolution