Traceroute#
Workflows → TTraceroutes
Documentation coming soon!
Custom Resource Definition#
To browse the Custom Resource Definition go to crd.eda.dev.
TraceRoute
SPEC
TraceRouteSpec defines the desired state of TraceRoute
-
Destination to TraceRoute to. This is a single IP address (IPv4 or IPv6) or a hostname that resolves to an IP address.
-
The network instance to use for the TraceRoute. This is the named network instance on the node, typically "default" or some other base name. If not specified, the default network instance will be used, which is typically the main/default/global network interface on the node.
default: "default" -
List of selectors to select nodes to perform TraceRoutes on. This matches labels on TopoNode resources, including those TopoNodes in the list of nodes that TraceRoutes will be performed on. If no nodes are specified, and no node selectors are specified, all nodes in the given namespace will be selected.
-
List of nodes to perform TraceRoutes from. Items in the list should be the names of the nodes, where each node will have a TraceRoute performed on it. If no nodes are specified, and no node selectors are specified, all nodes in the given namespace will be selected.
-
Additional options for the TraceRoute operation, such as number of pings to send, packet size, etc.
default: {}-
Disable fragmentation of IPv4 TraceRoute packets by setting the "Don't Fragment" flag. Default value is false, which means fragmentation is allowed for IPv4 packets.
default: false -
Disable ASN lookup for TraceRoute hops. This can speed up TraceRoutes by not performing ASN lookups for each hop. Default value is false, which means ASN lookups will be performed for each hop.
default: false -
Disable DNS resolution for TraceRoute hops. This can speed up TraceRoutes by not performing DNS lookups for each hop. Default value is false, which means DNS lookups will be performed for each hop.
default: false -
Initial TTL (Time To Live) value for the TraceRoute packets. Default is 1.
default: 1format: int32 -
Layer3 protocol to use for the TraceRoute. This can be either "IPv4" or "IPv6". If not specified, the protocol will be determined based on the destination address (IPv4 or IPv6).
default: "Unspecified"enum: "Unspecified", "IPv4", "IPv6" -
Layer4 protocol to use for the TraceRoute. This can be either "ICMP", "TCP", or "UDP". If not specified, the default will be "UDP".
default: "UDP"enum: "ICMP", "TCP", "UDP" -
Maximum TTL (Time To Live) value for the TraceRoute packets. Default is 30.
default: 30format: int32 -
TimeoutMilliSeconds is the timeout per hop in milliseconds.
default: 5000format: int32
-
STATUS
TraceRouteStatus defines the observed state of TraceRoute
-
Details contains the results of the pings performed on each node. Each entry in the list corresponds to a node that was pinged.
-
NodeTraceRouteResult defines the TraceRoute result, per Node.
-
Details of the TraceRoute result, if available.
default: {}-
The IPv4 or IPv6 address of the destination.
-
The name of the destination, if DNS resolution is enabled and successful.
-
The details of each hop in the TraceRoute, including the hop ID, address, hostname, ASN, RTT, and whether it responded to the probe.
-
HopDetail defines the status of each hop in the TraceRoute result.
-
The IPv4 or IPv6 address of the hop.
-
The Autonomous System Number (ASN) associated with the hop, if ASN lookup is enabled and successful.
format: int32 -
The hop ID, which alligns with the TTL value for that hop. Currently gNOI sends a single probe per TTL value, explicitly setting the HopID in case multiple probes per TTL value are sent in the future.
format: int32 -
The Resolved hostname of the hop, if DNS resolution is enabled and successful.
-
Indicates if the hop responded to the TraceRoute probe.
default: false -
The round-trip time (RTT) to the hop in milliseconds.
-
The state of the hop, as returned by gNOI.
-
-
-
The maximum number of hops to returned by gNOI for the TraceRoute. This is the same amount as specified in the TraceRouteOptions in spec.
format: int32 -
The size of the packets sent by gNOI for the TraceRoute.
format: int32
-
-
Error message, if the TraceRoute failed.
-
Network instance used to source the TraceRoute from.
default: "default" -
Node the TraceRoute was sourced from.
-
Indicates if the TraceRoute was successful.
default: false
-
-
-
Result is the overall result of the TraceRoute operation. It can be one of the following values: - "Success": All TraceRoutes were successful. - "Failed": No TraceRoutes were successful. - "PartialSuccess": Some TraceRoutes were successful, but not all.
default: "Success"enum: "Success", "Failed", "PartialSuccess"