# Juju

> Juju is an open source orchestration engine for deploying, integrating, and managing applications across Kubernetes, VMs, and bare metal using software operators called charms.


2026 CC-BY-SA, Canonical Ltd.

## Pages in this subsection

- [Resource (compute)](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute.md): Compute resource reference: machines and Kubernetes containers provisioned by Juju for application deployments.
- [List of commands available on a compute resource provisioned by Juju](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju.md): Browse commands available on Juju-provisioned compute resources, including juju-dumplogs, juju-exec, and juju-introspect for debugging.
- [`juju-dumplogs`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/juju-dumplogs.md): Access Juju controller logs using juju-dumplogs command when the controller isn't functioning. Export logs from local database.
- [`juju-exec`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/juju-exec.md): Execute commands in a unit's hook context using juju-exec, including relation context, remote units, and operator-specific execution.
- [`juju-introspect`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/juju-introspect.md): Introspect Juju agents running on machines using juju-introspect command. Access debugging macros and agent diagnostic information.
- [List of `juju-introspect` macros](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros.md): Explore juju-introspect macros for debugging Juju agents, including CPU profiling, goroutine analysis, and engine reports.
- [`juju_controller_agent_name`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_controller_agent_name.md): Get the controller agent name using juju_controller_agent_name introspect macro. Available only on Juju controller machines.
- [`juju_cpu_profile`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_cpu_profile.md): Profile CPU performance of Juju agent processes using juju_cpu_profile macro with pprof for debugging performance issues.
- [`juju_engine_report`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_engine_report.md): View Juju agent dependency engine status using juju_engine_report. Debug worker states and dependencies on any Juju machine.
- [`juju_goroutines`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_goroutines.md): List running goroutines from Juju agents using juju_goroutines introspect macro to identify stuck processes and debug issues.
- [`juju_heap_profile`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_heap_profile.md): Monitor memory allocation and find memory leaks in Juju agents using juju_heap_profile introspect macro with heap profiling.
- [`juju_controller_agent_name`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_machine_agent_name.md): Retrieve the machine agent name using juju_machine_agent_name introspect macro for identifying running Juju agents.
- [`juju_machine_lock`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_machine_lock.md): Check hook execution lock status across Juju agents using juju_machine_lock to see which units hold or wait for locks.
- [`juju_metrics`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_metrics.md): Access current Juju agent metrics using juju_metrics introspect tool for monitoring and debugging deployed systems.
- [`juju_presence_report`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_presence_report.md): View Juju agent connection status and liveness using juju_presence_report on controller machines to monitor API connections.
- [`juju_pubsub_report`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_pubsub_report.md): View pubsub connections and message queue details from Juju controllers using juju_pubsub_report for diagnostics.
- [`juju_start_unit`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_start_unit.md): Start a stopped unit agent within a single Juju process using juju_start_unit introspect function on deployed machines.
- [`juju_statepool_report`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_statepool_report.md): View MongoDB session pool details for each model using juju_statepool_report diagnostic tool on Juju controller machines.
- [`juju_statetracker_report`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_statetracker_report.md): Profile MongoDB state instance creation using juju_statetracker_report diagnostic tool on Juju controller machines.
- [`juju_stop_unit`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_stop_unit.md): Stop a unit agent running within a single Juju process using juju_stop_unit introspect function on deployed machines.
- [`juju_unit_agent_name`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_unit_agent_name.md): Get the unit agent name using juju_unit_agent_name introspect macro to identify running Juju unit and application agents.
- [`juju_unit_status`](https://documentation.ubuntu.com/juju/3.6/reference/resource-compute/list-of-commands-available-on-a-compute-resource-provisioned-by-juju/list-of-juju-introspect-macros/juju_unit_status.md): Check status of unit agents running within a single Juju process using juju_unit_status introspect function.

## Optional

- [Top-level llms.txt](https://documentation.ubuntu.com/juju/3.6/llms.txt): Complete documentation index.