Skip to main content

Troubleshooting

BoundaryDiagnosticOwner to inspect
Model resolutionExact ID/revision, config, auth, local assetsPython family descriptor/plugin
TensorRT buildFirst parser/builder error, shapes, precision, workspaceFamily builder and backend
Bundletrtmc inspect, section list, checksumBundle writer/format
Runtime dispatchNative strategy or optimized descriptorModel DSO or provider adapter
Dependency loadLoader error, DSO search path, ABI cohortHost environment/backend/provider
Task executionExact input, request config, first runtime errorModel pipeline/task implementation
ValidationOracle, comparator, thresholds, skipped prerequisitesE2E manifest and harness
PerformanceTiming boundary, warmup, variance, quality gateBenchmark configuration

Preserve the first error and the complete command. Retrying with several unrelated flags can hide the original ownership boundary.

For a new installation, start with First-run Troubleshooting. For a model result, reproduce the exact model-owned manifest before opening a generalized framework issue.

When the failure is reproducible, follow Get Help and File an Issue to select the right issue form and include the exact environment, model revision, commands, expected behavior, observed behavior, and first error.