Recent disruptions to two undersea internet cables in the Baltic Sea have yet again...
4.9 Explorer settings
4.9.1 explorer.aipi #
If enabled, AIPI (Adaptive Inter-Packet Interval) algorithm is executed using inter-packet intervals configured for each provider.
- Possible values:
0 (Disabled), 1 (Enabled) - Default value:
0 - Recommended value:
0
4.9.2 explorer.algorithms #
Enables or disables the use of new scanning, probing and tracing Explorer algorithms.
- Possible values:
0 (Disabled), 1(Enabled) - Default value:
0
4.9.3 explorer.high_vol_precedence #
High volume tasks have priority over the tasks with variable cardinality.
The parameter establishes the balance between the tasks allocated for processing high volume prefixes (high priority for the Customer network) and the network events tasks (such as blackout, congestion, etc).
- Possible values:
10-90 - Default value:
50
4.9.4 explorer.infra_ips #
Defines the IPv4/IPv6 addressees, used in internal infrastructure to determine the current route for a specific prefix. If netmask is not specified, then /32 is assumed for IPv4 address and /128 for IPv6 address (host addresses).
Format:
- Space-separated list of infrastructure IPv4/IPv6 addresses.
- Absolute path to a newline-separated file containing a list of local IPv4/IPv6 prefixes that should be analyzed and optimized by the IRP.
- Possible values: See above.
- Recommended value: all IPv4/IPv6 addresses used in the internal infrastructure.
4.9.5 explorer.interval.infra #
Defines the time interval (in milliseconds) between the packets sent to infrastructure hops (explorer.infra_ips). By decreasing this value the Explorer performance enhances.
- Possible values:
1-200 - Default value:
5 - Recommended value:
5
4.9.6 explorer.interval.other #
Defines the time interval (in milliseconds) between the packets sent to destination hops (explorer.infra_ips).
- Possible values:
1-1000 - Default value:
200 - Recommended value:
200
4.9.7 explorer.interval.other.trace #
Defines the time interval (in milliseconds) between traceroute packets sent to non-infrastructure hops.
- Possible values:
1-1000 - Default value:
20 - Recommended value:
20
4.9.8 explorer.ipv4_test #
Defines public IPv4 address that will be used for ensuring that PBR is operational.
- Possible values:
IPv4 address - Default value:
8.8.8.8 - Recommended value:
8.8.8.8
4.9.9 explorer.ipv6_test #
Defines public IPv6 address that will be used to verify that PBR is operational.
- Possible values:
IPv6 address - Default value:
2620:0:ccc::2 - Recommended value:
2620:0:ccc::2
4.9.10 explorer.log #
Defines the file-system path to the explorer log file.
- Default value:
/var/log/irp/explorer.log
4.9.11 explorer.log.level #
Defines the logging level for the explorer service.
- Possible values:
emerg, fatal, alert, crit, error, warn, notice, info, debug, trace - Default value:
info - Recommended value:
info
4.9.12 explorer.max_collector_ips #
Process max collected IPs. Maximum number of IPs to probe for a specific prefix.
- Possible values:
1-256 - Default value:
10
4.9.13 explorer.maxthreads #
Defines the number of simultaneously processed exploring tasks.
If this value is excessively large Explorer tasks can take very long to finish. Hardware/router diagnostic packet rate limitations kick in causing all threads to wait for exploring tasks to finish.- Possible values:
10-2000 - Default value:
200 - Recommended value:
200-300
4.9.14 explorer.probe.algorithm #
Defines the probing algorithm(s) used by explorer, in the preferred order.
The following algorithms can be used:
UDP – udp requests (destination port: 33434)
ICMP – regular ICMP ping sweep
TCP_SYN – tcp syn scan (destination port: 33434)
- Possible values:
ICMP UDP TCP_SYN - Default value:
ICMP UDP TCP_SYN - Recommended value:
ICMP UDP TCP_SYN
4.9.15 explorer.probe.indirect_priority #
Defines the execution priority between direct and indirect probing algorithms. Parameter value of 1 means that indirect probing will be executed prior to direct probing algorithm. Parameter value of 2 disables indirect probing.
This parameter conflicts with explorer.trace.all configuration option.- Possible values:
0 (Direct then Indirect), 1 (Indirect then Direct), 2 (Direct only) - Default value:
0 - Recommended value:
0
4.9.16 explorer.probing.sendpkts.adaptive_max #
Defines the maximum number of ping packets for adaptive prefix probing.
- Possible values: positive Integer value, higher or equal to explorer.probing.sendpkts.min
- Possible values:
1-1000 - Default value:
100
4.9.17 explorer.probing.sendpkts.min #
Defines the default ping packets count for each probe. If any loss is detected, additional packets (up to explorer.probing.sendpkts.adaptive_max) are sent, for a more accurate packet loss detection.
- Possible values:
1-1000 - Default value:
5
4.9.18 explorer.probing.simultaneous #
Defines the number of scanned IP addresses.
- Possible values:
1-100 - Default value:
50 - Recommended value:
50
4.9.19 explorer.scanning.confirm_ips #
Defines the number of scanned speaking IP addresses for a provider with loss.
- Possible values:
1-10 - Default value:
5 - Recommended value:
5
4.9.20 explorer.scanning.replypkts.min #
Defines the number of response packets from a scanned speaking IP address to qualify as a candidate.
- Possible values:
1-10 - Default value:
5 - Recommended value:
5
4.9.21 explorer.scanning.rtt.dispersion_ms #
Defines RTT maximum dispersion in miliseconds to qualify a speaking IP as candidate.
- Possible values:
1-1000 - Default value:
50 - Recommended value:
50
4.9.22 explorer.scanning.sendpkts.factor #
Defines the number of attempts to send packets to all selected speaking IPs.
- Possible values:
1-10 - Default value:
5 - Recommended value:
5
4.9.23 explorer.timeout #
Defines the probes ICMP timeout (in ms)
- Possible values:
50-10000 - Default value:
2000
4.9.24 explorer.timeout.infra #
Defines the waiting time (in milliseconds) for infrastructure hops’ (explorer.infra_ips) responses expected during trace execution.
- Possible values:
50-20000 - Default value:
10000 - Recommended value:
10000
4.9.25 explorer.trace.algorithms #
Defines the traceroute algorithm(s) to be used, arranged by priority. See explorer.probe.algorithm for algorithms description.
- Possible values:
UDP ICMP TCP_SYN - Default value:
UDP ICMP - Recommended value:
UDP ICMP
4.9.26 explorer.trace.all #
Defines tracing behaviour. If traces are forced, each probed prefix unconditionally runs traces through all configured providers. Regular tracing is needed for Outage Detection and for AS Path reconstruction. Traces can be disabled altogether by setting explorer.trace.all to 2.
Third algorithm should be enabled in bgpd.as_path when traces are fully disabled.Forcing ALL traces (explorer.trace.all = 1) can significantly slow down probing for networks. Review probing times before and after changing this parameter and if probing times become unacceptable revert to previous setting.When all traces are disablled (explorer.trace.all = 2) IRP is missing essential trace data and is not able to take action on some types of problems. This effectively cuts off those features.- Possible values:
0 (Regular), 1 (Force all), 2 (Disable all) - Default value:
0 - Recommended value:
0
4.9.27 explorer.trace.diag_hop_unique #
Enforces the uniqueness of per-provider diagnostic hops peer.X.ipv4.diag_hop, peer.X.ipv6.diag_hop.
- Possible values:
0 (Disabled), 1 (Enabled) - Default value:
1
4.9.28 explorer.traceroute.retrypkts #
Defines the number of additional traceroute packets to be sent to the intermediate hop in case it has not replied and might be an infrastructure boundary hop.
- Possible values:
0-50 - Default value:
10 - Recommended value:
10
4.9.29 explorer.traceroute.sendpkts #
Defines the number of traceroute packets per hop to be sent for each probe.
- Possible values:
3-5 - Default value:
3 - Recommended value:
3
4.9.30 explorer.traceroute.simultaneous #
Defines the number of simultaneously probed hops during trace execution initiated from the hop defined by (explorer.traceroute.ttl.min).
- Possible values:
1-30 - Default value:
5 - Recommended value:
5
4.9.31 explorer.traceroute.simultaneous.infra #
Defines the number of simultaneously probed infrastructure hops during trace execution.
- Possible values:
1-30 - Default value:
3 - Recommended value:
3
4.9.32 explorer.traceroute.ttl.max #
Defines the maximum traceroute TTL. Essentially this defines the last hop at which explorer stops the trace.
- Possible values:
1-255 - Default value:
30 - Recommended value:
30
4.9.33 explorer.traceroute.ttl.min #
Defines the minimum traceroute TTL. Basically this defines the first hop after which explorer analyzes the trace.
- Possible values:
1-255 - Default value:
2 - Recommended value:
2-5