f5os_device_info – Collect information from F5OS devices

New in version 1.0.0.

Synopsis

  • Collect information from F5OS devices.

Parameters

Parameter Choices/Defaults Configuration Comments
gather_subset
list / elements=string / required
    Choices:
  • all
  • interfaces
  • lag-interfaces
  • vlans
  • controller-images
  • partition-images
  • tenant-images
  • system-info
  • !all
  • !interfaces
  • !lag-interfaces
  • !vlans
  • !controller-images
  • !partition-images
  • !tenant-images
  • !system-info
When supplied, this argument restricts the information returned to a given subset.
You can specify a list of values to include a larger subset.
Values can also be used with an initial ! to specify that a specific subset should not be collected.

aliases: include

Examples

- name: Collect interface and vlan information on F5OS device
  f5os_device_info:
    gather_subset:
      - interfaces
      - vlans

- name: Collect all F5OS device information
  f5os_device_info:
    gather_subset:
      - all

- name: Collect all F5OS device information except system-info
  f5os_device_info:
    gather_subset:
      - all
      - "!system-info"

Return Values

The following are the fields unique to this module:

Key Returned Description
interfaces
complex
When interfaces is specified in gather_subset.
Information about interfaces on the platform.

Sample:
hash/dictionary of values
  admin_status
string
queried
Returns the interface admin status as set by the user.

Sample:
DOWN
  enabled
boolean
queried
Indicates if the interface is enabled.

Sample:
True
  l2_counters
dictionary
queried
Frames interface counters.

Sample:
hash/dictionary of values
    in-8021q-frames
string
queried
Number of incoming 802.1Q frames.

    in-crc-errors
string
queried
Number of incoming frames with cyclic redundancy check error

    in-fragment-frames
string
queried
Number of incoming fragment frames.

    in-jabber-frames
string
queried
Number of incoming jabber frames.

    in-mac-control-frames
string
queried
Number of incoming mac control frames.

    in-mac-pause-frames
string
queried
Number of incoming mac pause frames.

    in-oversize-frames
string
queried
Number of incoming oversize frames.

    out-8021q-frames
string
queried
Number of outbound 802.1Q frames.

    out-mac-control-frames
string
queried
Number of outbound mac control frames.

    out-mac-pause-frames
string
queried
Number of outbound mac pause frames.

  l3_counters
dictionary
queried
Packets interface counters.

Sample:
hash/dictionary of values
    in-broadcast-pkts
string
queried
Number of broadcasts packets received.

    in-discards
string
queried
Number of inbound packets discarded for reasons other than content error.

    in-errors
string
queried
Number of inbound packets discarded for content error.

    in-fcs-errors
string
queried
Number of inbound packets with frame check sequence error.

    in-multicast-pkts
string
queried
Number of multicast packets received.

    in-octets
string
queried
Number of octets received.

    in-unicast-pkts
string
queried
Number of unicast packets received.

    out-broadcast-pkts
string
queried
Number of outbound broadcast packets.

    out-discards
string
queried
Number of outbound packets discarded for reasons other than content error.

    out-errors
string
queried
Number of outbound packets discarded for content errors.

    out-multicast-pkts
string
queried
Number of outbound multicast packets.

    out-octets
string
queried
Number of outbound octets.

    out-unicast-pkts
string
queried
Number of outbound unicast packets.

  loopback_mode
boolean
queried
Indicates if the interface is set in loopback mode.

  mac_address
string
queried
Returns the MAC address of the interface.

Sample:
00:94:a1:69:4f:02
  name
string
queried
Name of the interface as designated on the F5OS device.

Sample:
1.1
  operational_status
string
queried
Returns the interface operational status.

Sample:
UP
  port_speed
string
queried
Returns the set port speed of the interface.

Sample:
25G
lag_interfaces
complex
When lag-interfaces is specified in gather_subset.
Information about Link Aggregate Group (LAG) interfaces on the platform.

Sample:
hash/dictionary of values
  distribution_hash
string
queried
The type of LAG hashing algorithm.

Sample:
src-dst-ipport
  enabled
boolean
queried
Indicates if the LAG interface is enabled.

Sample:
True
  lag_speed
integer
queried
Returns the speed of the LAG interface.

Sample:
100
  lag_type
string
queried
Returns the type of LAG interface.

Sample:
STATIC
  mac_address
string
queried
Returns the MAC address of the LAG interface.

Sample:
00:94:a1:69:5d:17
  members
dictionary
queried
Returns the list of members of the LAG interface.

Sample:
hash/dictionary of values
    name
string
queried
Name of the interface.

Sample:
1.0
    status
string
queried
Status of the interface.

Sample:
DOWN
  mtu
integer
queried
Returns the MTU value of the LAG interface.

Sample:
9600
  name
string
queried
Name of the LAG interface as designated on the F5OS device.

Sample:
backbone_trunk
  native_vlan
integer
queried
Returns the vlan id of the native vlan associated with the LAG interface.

Sample:
100
  operational_status
string
queried
Returns the LAG interface operational status.

Sample:
UP
  trunk_vlans
list
queried
Returns the list of vlan ids of trunk vlans associated with the LAG interface.

Sample:
[100, 200]
system_info
complex
When system-info is specified in gather_subset.
System Information on the F5OS platform.

Sample:
hash/dictionary of values
  components
complex
queried
Specifies a list of components of the target platform.
Currently only blade, chassis, and controller components information is collected on VELOS platform.
General platform information is collected for rSeries devices.

    description
string
queried
Full name of the platform.
Only collected on rSeries.

Sample:
r10900
    memory_usage
complex
queried
Overall memory usage on the platform.

Sample:
hash/dictionary of values
      free
integer
queried
Free memory in bytes available on the platform.

Sample:
17659666432
      total
integer
queried
Total memory in bytes present on the platform.

Sample:
19356536832
      used_percent
integer
queried
Percentage of used memory on the platform.

Sample:
25
    name
string
queried
Name of the component.

Sample:
blade-1
    part_no
string
queried
Part number of the component.

Sample:
000-9999-88 REV 99
    serial_no
string
queried
Serial number of the component.

Sample:
f5-abcd-efgh
    system_temperature
complex
queried
General information on system temperature, all values given in Celsius.

Sample:
hash/dictionary of values
      average
float
queried
Average temperature measured on the system during its uptime.

Sample:
35.4
      current
float
queried
Current temperature as measured on the system.

Sample:
25.4
      maximum
float
queried
Maximum temperature recorded on the system during its uptime.

Sample:
39.2
      minimum
float
queried
Minimum temperature recorded on the system during its uptime.

Sample:
20.1
  installed_license
complex
queried
License information as present on the platform.

Sample:
hash/dictionary of values
    base_registration_key
string
queried
Base registration key of the license.

Sample:
YYYYY-XXXXX-FFFFF-GGGG-JJJJJJ
    dossier
string
queried
Dossier generated by device.

Sample:
01350fe7daea9e21a4ee
    license_date
string
queried
Date when the system was licensed.

Sample:
2021/08/01
    service_check_date
string
queried
Date when last service check was performed on the license.

Sample:
2021/12/01
  platform_type
string
queried
Type of platform on which the info is being gathered.

Sample:
rSeries Platform
  running_software
complex
queried
Information on the current version of F5OS software running on the device.

Sample:
hash/dictionary of values
    blade_name
string
queried
Blade on which the software is running.
This is only collected when querying VELOS partitions.

Sample:
blade-1
    controller_name
string
queried
Controller on which the software is running.
This is only collected when querying VELOS controllers.

Sample:
controller-1
    os_version
string
queried
Version of OS component in the current running software.

Sample:
1.3.2-9645
    service_version
string
queried
Version of service component in the current running software.

Sample:
1.3.2-9645
tenant_images
complex
When tenant-images is specified in gather_subset.
Information about tenant images uploaded on the F5OS platform.

Sample:
hash/dictionary of values
  in_use
boolean
queried
Indicates if the tenant image is currently in use.

  name
string
queried
Name of the uploaded ISO file.

Sample:
BIGIP-15.1.5-0.0.10.ALL-F5OS.qcow2.zip.bundle
  status
string
queried
Status of the uploaded tenant image ISO.

Sample:
verified
velos_controller_images
complex
When controller-images is specified in gather_subset.
Information about F5OS controller ISO images uploaded on the VELOS controller.

Sample:
hash/dictionary of values
  os
string
queried
Version of OS component in the uploaded ISO file.

Sample:
1.2.1-10781
  service
string
queried
Version of service component in the uploaded ISO file.

Sample:
1.2.1-10781
  version
string
queried
Version of the uploaded ISO file.

Sample:
1.2.1-10781
velos_partition_images
complex
When partition-images is specified in gather_subset.
Information about F5OS partition ISO images uploaded on the VELOS controller.

Sample:
hash/dictionary of values
  os
string
queried
Version of OS component in the uploaded F5OS ISO file.

Sample:
1.2.1-10781
  service
string
queried
Version of service component in the uploaded F5OS ISO file.

Sample:
1.2.1-10781
  version
string
queried
Version of the uploaded F5OS ISO file.

Sample:
1.2.1-10781
vlans
complex
When vlans is specified in gather_subset.
Information about VLANs on the platform.

Sample:
hash/dictionary of values
  name
string
queried
Name of the VLAN

Sample:
vlan-444
  vlan_id
integer
queried
VLAN tag as configured on device.

Sample:
444


Status

Authors

  • Wojciech Wypior (@wojtek0806)