vyos.vyos.vyos_ping module – Tests reachability using ping from VyOS network devices

Note

This module is part of the vyos.vyos collection (version 5.0.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install vyos.vyos.

To use it in a playbook, specify: vyos.vyos.vyos_ping.

New in vyos.vyos 1.0.0

Synopsis

Aliases: ping

Parameters

Parameter

Comments

count

integer

Number of packets to send to check reachability.

Default: 5

dest

string / required

The IP Address or hostname (resolvable by the device) of the remote node.

interval

integer

Determines the interval (in seconds) between consecutive pings.

size

integer

Determines the size (in bytes) of the ping packet(s).

source

string

The source interface or IP Address to use while sending the ping packet(s).

state

string

Determines if the expected result is success or fail.

Choices:

  • "absent"

  • "present" ← (default)

ttl

integer

The time-to-live value for the ICMP packet(s).

Notes

Note

Examples

- name: Test reachability to 10.10.10.10
  vyos.vyos.vyos_ping:
    dest: 10.10.10.10

- name: Test reachability to 10.20.20.20 using source and ttl set
  vyos.vyos.vyos_ping:
    dest: 10.20.20.20
    source: eth0
    ttl: 128

- name: Test reachability to 10.30.30.30 using interval
  vyos.vyos.vyos_ping:
    dest: 10.30.30.30
    interval: 3
    state: absent

- name: Test reachability to 10.40.40.40 setting count and source
  vyos.vyos.vyos_ping:
    dest: 10.40.40.40
    source: eth1
    count: 20
    size: 512

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

commands

list / elements=string

List of commands sent.

Returned: always

Sample: ["ping 10.8.38.44 count 10 interface eth0 ttl 128"]

packet_loss

string

Percentage of packets lost.

Returned: always

Sample: "0%"

packets_rx

integer

Packets successfully received.

Returned: always

Sample: 20

packets_tx

integer

Packets successfully transmitted.

Returned: always

Sample: 20

rtt

dictionary

The round trip time (RTT) stats.

Returned: when ping succeeds

Sample: {"avg": 2, "max": 8, "mdev": 24, "min": 1}

Authors

  • Nilashish Chakraborty (@NilashishC)