inspect command#
Description#
The inspect
command provides the information about the deployed labs.
Usage#
containerlab [global-flags] inspect [local-flags]
Flags#
all#
With the local --all
flag it's possible to list all deployed labs in a single table. The output will also show the relative path to the topology file that was used to spawn this lab.
The lab name and path values will be set for the first node of such lab, to reduce the clutter. Refer to the examples section for more details.
topology | name#
With the global --topo | -t
or --name | -n
flag a user specifies which particular lab they want to get the information about.
When the topology file flag is omitted, containerlab will try to find the matching file name by looking at the current working directory. If a single file is found, it will be used.
format#
The local --format
flag enables different output stylings. By default the table view will be used.
Currently, the only other format option is json
that will produce the output in the JSON format.
details#
The inspect
command produces a brief summary about the running lab components. It is also possible to get a full view on the running containers by adding --details
flag.
With this flag inspect command will output every bit of information about the running containers. This is what docker inspect
command provides.
Examples#
List all running labs on the host#
❯ containerlab inspect --all
+---+------------+----------+-----------------+--------------+--------------------+------+-------+---------+----------------+----------------------+
| # | Topo Path | Lab Name | Name | Container ID | Image | Kind | Group | State | IPv4 Address | IPv6 Address |
+---+------------+----------+-----------------+--------------+--------------------+------+-------+---------+----------------+----------------------+
| 1 | newlab.yml | newlab | clab-newlab-n1 | 3c8262034088 | srlinux:20.6.3-145 | srl | | running | 172.20.20.4/24 | 2001:172:20:20::4/80 |
| 2 | | | clab-newlab-n2 | 79c562b71997 | srlinux:20.6.3-145 | srl | | running | 172.20.20.5/24 | 2001:172:20:20::5/80 |
| 3 | srl02.yml | srl01 | clab-srl01-srl | 13c9e7543771 | srlinux:20.6.3-145 | srl | | running | 172.20.20.2/24 | 2001:172:20:20::2/80 |
| 4 | | | clab-srl01-srl2 | 8cfca93b7b6f | srlinux:20.6.3-145 | srl | | running | 172.20.20.3/24 | 2001:172:20:20::3/80 |
+---+------------+----------+-----------------+--------------+--------------------+------+-------+---------+----------------+----------------------+
Provide information about a specific running lab by its name#
Provide information about the running lab named srlceos01
❯ containerlab inspect --name srlceos01
+---+---------------------+--------------+---------+------+-------+---------+----------------+----------------------+
| # | Name | Container ID | Image | Kind | Group | State | IPv4 Address | IPv6 Address |
+---+---------------------+--------------+---------+------+-------+---------+----------------+----------------------+
| 1 | clab-srlceos01-ceos | 90bebb1e2c5f | ceos | ceos | | running | 172.20.20.4/24 | 2001:172:20:20::4/80 |
| 2 | clab-srlceos01-srl | 82e9aa3c7e6b | srlinux | srl | | running | 172.20.20.3/24 | 2001:172:20:20::3/80 |
+---+---------------------+--------------+---------+------+-------+---------+----------------+----------------------+
Provide information about a specific running lab by its topology file#
❯ clab inspect -t srl02.clab.yml
INFO[0000] Parsing & checking topology file: srl02.clab.yml
+---+-----------------+--------------+-----------------------+------+---------+----------------+----------------------+
| # | Name | Container ID | Image | Kind | State | IPv4 Address | IPv6 Address |
+---+-----------------+--------------+-----------------------+------+---------+----------------+----------------------+
| 1 | clab-srl02-srl1 | 7a7c101be7d8 | ghcr.io/nokia/srlinux | srl | running | 172.20.20.4/24 | 2001:172:20:20::4/64 |
| 2 | clab-srl02-srl2 | 5e3737621753 | ghcr.io/nokia/srlinux | srl | running | 172.20.20.5/24 | 2001:172:20:20::5/64 |
+---+-----------------+--------------+-----------------------+------+---------+----------------+----------------------+
Provide information about a specific running lab in json format#
❯ containerlab inspect --name srlceos01 -f json
[
{
"lab_name": "srlceos01",
"name": "clab-srlceos01-srl",
"container_id": "82e9aa3c7e6b",
"image": "srlinux",
"kind": "srl",
"state": "running",
"ipv4_address": "172.20.20.3/24",
"ipv6_address": "2001:172:20:20::3/80"
},
{
"lab_name": "srlceos01",
"name": "clab-srlceos01-ceos",
"container_id": "90bebb1e2c5f",
"image": "ceos",
"kind": "ceos",
"state": "running",
"ipv4_address": "172.20.20.4/24",
"ipv6_address": "2001:172:20:20::4/80"
}
]