Webull Apps | Session Tracking & Network Condition Analysis

Session tracking monitors authentication state across network conditions. When a session fails to progress, network interruptions, policy blocks, or connection timeouts may be the root cause.

This tracker documents how network conditions affect session state. Each session checkpoint—account selection, credential entry, MFA method, redirect handoff—depends on stable network connectivity. Network changes during the flow can invalidate session tokens or trigger policy blocks.

Network conditions vary: cellular data may have higher latency than WiFi, VPN connections may trigger policy evaluations, and office networks may have different firewall rules than home connections. Session tracking helps identify whether the issue is network-related or session-related.

Verification focuses on network state without requiring credential entry. Check network connectivity, signal strength on mobile, VPN status, firewall rules, and session token freshness. These checks help determine if the session failure is due to network conditions or session state.

After 2-3 session attempts, pause for 5-15 minutes to respect rate limiting. Escalation requires session tracking data: network type and conditions, session state identifier, error messages, timestamp with timezone, device and OS details, browser version, the failing checkpoint, and what network verification was performed—excluding login credentials or session tokens.

Session State Tracking

Session Track: Spinner Persists on Network Interruption

Session State: Session Stall

Network Condition: Network interruption occurs during session processing. Connection drops or becomes unstable mid-flow.

Observable Symptoms: Spinner appears and persists beyond normal processing time. Network indicator shows connection lost or unstable. Session state may be stuck waiting for network response.

Session Impact: Network interruption invalidates session request or causes session timeout. Session state cannot progress without stable network.

Verification: Track session state and verify network. Check network conditions and retry session. Monitor session progress and attempt again.

Safe Actions: Verify session token and network connection. Test session tracking and observe network. Wait for network stability before retrying.

Expected Result: Session should resume after network reconnection, or clear error should explain network session interruption

Stop Point: Session boundary: pause 5-15 minutes after 2-3 attempts. Rate limit session requires waiting period.

Escalation Evidence: Network interruption details, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude session tokens.

Session Track: Blank Screen on Network Timeout

Session State: Session Stall

Network Condition: Network timeout occurs during session initialization. Connection fails before session can be established.

Observable Symptoms: Screen displays completely blank. Network timeout error may appear. Session cannot initialize due to network failure.

Session Impact: Network timeout prevents session creation. Session state never transitions from initial state due to network connectivity failure.

Verification: Check network conditions and retry session. Track session state and verify network. Monitor session progress and attempt again.

Safe Actions: Test session tracking and observe network. Verify network connectivity and retry. Test on different network connection.

Expected Result: Session should initialize on stable network, or clear error should explain network session timeout

Stop Point: Session throttle: wait before next attempt. Retry discipline: 5-15 minute pause for session.

Escalation Evidence: Network timeout details, session state identifier, network type, connectivity test results, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude network credentials.

Session Track: MFA Selection Fails on Network Change

Session State: Session Verification

Network Condition: Network changes during MFA step. Device switches from WiFi to cellular or network handoff occurs.

Observable Symptoms: MFA selection interface appears but selection fails. Network change invalidates session state or MFA request times out.

Session Impact: Network change during MFA step invalidates session token or causes MFA request failure. Session state cannot transition to next checkpoint.

Verification: Track session state and verify network. Check network conditions and retry session. Monitor session progress and attempt again.

Safe Actions: Complete MFA step on stable network. Verify session token and network connection. Test session tracking and observe network.

Expected Result: MFA should complete on stable network, or clear error should explain network session change impact

Stop Point: Network session boundary: pause 5-15 minutes after 2-3 attempts. Session network change requires waiting period.

Escalation Evidence: Network change details, MFA step identifier, session state, network type before/after, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude MFA codes.

Session Track: Redirect Loop on Network Policy

Session State: Session Transfer

Network Condition: Network policy blocks redirect or network firewall interferes with redirect handoff

Observable Symptoms: Page continuously redirects between URLs. Network policy may be blocking redirect completion or causing redirect loop.

Session Impact: Network policy blocks redirect handoff causing session transfer to fail. Session state loops without completing transfer.

Verification: Check network conditions and retry session. Track session state and verify network. Monitor session progress and attempt again.

Safe Actions: Test on network without policy restrictions. Verify session token and network connection. Test session tracking and observe network.

Expected Result: Redirect should complete on policy-compliant network, or clear error should explain network policy session restrictions

Stop Point: Redirect session boundary: pause 5-15 minutes after 2-3 attempts. Session policy requires waiting period.

Escalation Evidence: Network policy details, redirect URL pattern, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude redirect tokens.

Session Track: Policy Block on Untrusted Network

Session State: Session Barrier

Network Condition: Session on untrusted network triggers policy block. VPN connection or public WiFi may be untrusted.

Observable Symptoms: Policy banner appears blocking access. Network untrusted status triggers session policy violation.

Session Impact: Untrusted network triggers policy block preventing session from proceeding. Session state cannot transition past policy checkpoint.

Verification: Track session state and verify network. Check network conditions and retry session. Monitor session progress and attempt again.

Safe Actions: Test on trusted network connection. Verify session token and network connection. Test session tracking and observe network.

Expected Result: Session should proceed on trusted network, or clear message should explain network trust session requirements

Stop Point: Policy session boundary: pause 5-15 minutes after 2-3 attempts. Session network trust requires waiting period.

Escalation Evidence: Network trust status, policy error message, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. No account information needed.

Session Track: Session Expiry on Network Delay

Session State: Session Timeout

Network Condition: Network delay causes session processing to exceed timeout window. Slow network extends session duration beyond limit.

Observable Symptoms: Session expiry message appears. Network delay caused session to exceed timeout window before completing flow.

Session Impact: Network delay extends session duration causing timeout. Session state expires before flow can complete.

Verification: Check network conditions and retry session. Track session state and verify network. Monitor session duration and network latency.

Safe Actions: Test on faster network connection. Verify session token and network connection. Complete steps more quickly to avoid timeout.

Expected Result: Session should complete within timeout on faster network, or clear warning should appear before expiry

Stop Point: Session timeout boundary: pause 5-15 minutes after 2-3 attempts. Session delay requires waiting period.

Escalation Evidence: Network delay details, session duration, timeout message, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude session tokens.

Session Track: Token Stale on Network Refresh

Session State: Any checkpoint during flow

Network Condition: Network refresh or reconnection invalidates session token. Network change causes token to become stale.

Observable Symptoms: Session token rejected error appears. Network refresh invalidates session token causing state to fail.

Session Impact: Network refresh invalidates session token. Session state cannot continue with stale token.

Verification: Track session state and verify network. Check network conditions and retry session. Monitor session token freshness.

Safe Actions: Restart session from beginning. Verify session token and network connection. Test session tracking and observe network.

Expected Result: Session should remain valid during stable network, or clear warning should appear before network refresh

Stop Point: Token session boundary: pause 5-15 minutes after 2-3 attempts. Session refresh requires waiting period.

Escalation Evidence: Network refresh details, token age, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. Exclude token values.

Session Track: Post-Authentication Fails on Network Drop

Session State: Session Load

Network Condition: Network connection drops after authentication completes. Post-authentication resource loading fails due to network loss.

Observable Symptoms: Authentication completes successfully but dashboard fails to load. Network drop occurs during post-authentication resource loading.

Session Impact: Network drop during post-authentication loading causes session to fail. Session state cannot complete initialization due to network loss.

Verification: Check network conditions and retry session. Track session state and verify network. Monitor session progress and attempt again.

Safe Actions: Test on stable network connection. Verify session token and network connection. Test session tracking and observe network.

Expected Result: Dashboard should load on stable network, or clear error should explain network session drop impact

Stop Point: Post-auth session boundary: pause 5-15 minutes after 2-3 attempts. Session network drop requires waiting period.

Escalation Evidence: Network drop details, post-authentication errors, session state identifier, network type, timestamp with timezone, device model, OS, browser version, failing checkpoint. No authentication tokens needed.

Network Condition Impact

Network conditions significantly impact session state. Different connection types affect session behavior:

Cellular Data Impact

Higher latency can cause session timeouts. Signal strength variations can interrupt session state. Network handoffs can invalidate session tokens.

WiFi Network Impact

Generally stable but office networks may have firewall rules that interfere with session state. Home WiFi usually more reliable for session tracking.

VPN Connection Impact

VPN location can trigger policy blocks affecting session state. VPN connection stability affects session reliability. Some VPN protocols may cause session interruptions.

Network Policy Impact

Office network policies may block session endpoints. Firewall rules can interfere with session state transitions. Network restrictions can cause session failures.

Escalation Tracking

When escalation is required, collect the following session tracking data. Do not include login credentials, passwords, account numbers, or personal identifiers.

  • Network Type and Conditions: Connection type, network stability, signal strength, VPN status
  • Session State Identifier: The specific session state where failure occurred (e.g., "Session Stall", "Session Transfer")
  • Error Messages: Exact error text or session error messages as displayed
  • Timestamp: Date and time of occurrence with timezone (e.g., 2026-01-27 14:30:00 EST)
  • Device and OS Details: Device model, operating system version, and configuration
  • Browser Version: Browser name, version, profile type, and configuration
  • Failing Checkpoint: The specific checkpoint where session failure occurred
  • Network Verification Performed: What network checks were attempted (connectivity test, signal strength, VPN status, firewall rules, session token freshness, etc.)