Diagnostic Overview

Use this section when installation, wrapper integration, or direct mate Python API usage does not behave as expected.

Quick Start

  1. Run mate check to validate the runtime environment.

  2. Run mate show-config to inspect versions, devices, architecture resolution, and JIT or AOT state.

  3. Run mate env to confirm the shell exports seen by MATE.

  4. Enable logging or Level 10 dumps when the failure requires deeper evidence.

  5. Replay or share the captured dump data when the issue must be reproduced.

Note

If one of the first three commands already explains the issue, you can stop there.

Primary Commands

mate check
mate show-config
mate env

Next Steps

Topic

Use Case

Command Line Interface

Runtime checks, environment inspection, module status, or dump replay.

Logging

Log levels, dump controls, environment variables, or replayable captures.

See Also

  • Go back to Overview if you are still choosing an integration path.

  • Go back to Wrappers if you are still working through a wrapper quickstart.

  • Continue with API Reference if the failure is in direct mate Python API usage.