Canisters

Check a canister's status, memory, history and controllers

All help topics

Open the canister from Software canisters: its page shows the essentials at the top and the details in four tabs.

  1. Open the engine, choose Software canisters in the sidebar and click the canister.
  2. Read the top card: its name, role, ID (with a copy button), the app it belongs to, and Status, Storage, Last updated and Created. Open opens its Canister URL in a new tab.
  3. Pick a tab for the details.

What each tab shows:

  • Metrics: Memory (its footprint, main memory and secondary memory), Query activity (Queries, Average response, Data transferred), and Platform resource use: the cycles it has used, split into Storage, Compute and Network, plus its One-time setup.
  • History: its Change history (created, installed, upgraded, controllers changed, snapshot loaded and more), grouped into Today, Yesterday, Previous 7 days, Previous 30 days and Older.
  • Environment: its environment variables, split into Runtime configuration and App metadata. Values stay hidden until you click Reveal all values or reveal a single row.
  • Properties: Canister URL, Engine ID, Subnet ID, Module hash, Module metadata and Controllers, the principals permitted to manage this canister.

Good to know

  • Every engine member can view a canister's page.
  • The page shows no cycle balance for a canister. Platform resource use is what it has used since reporting began.
  • A module can keep its build details private. Then Module metadata says Not visible to you to anyone but the canister's controllers. Nothing is wrong with the canister.
  • Only the most recent changes are kept on-chain, so very old history may be missing.
  • Copy diagnostics on the Properties tab copies the technical details for a support request. It leaves environment variable values out.
  • The way back to the list is the trail at the top of the page.

More about the same page

Still stuck? Contact support