Netra Troubleshooting

Use this skill to resolve common integration issues quickly and systematically.

Common Problems

• ModuleNotFoundError for netra.
• Missing extras for Presidio or prompt-injection scanner.
• Netra.init() called multiple times.
• Traces or metrics not visible in dashboard.
• Async or streaming flow not appearing as expected.

Triage Flow

1. Confirm package installation and Python version compatibility.
2. Confirm one-time initialization happens before provider imports.
3. Verify API key/header and OTLP endpoint configuration.
4. Verify enabled instruments match runtime libraries.
5. Confirm network egress and collector compatibility.
6. Confirm shutdown flush path for final telemetry.