bigip_qkview – Manage QKviews on the device

New in version 1.0.0.

Synopsis

  • Manages creating and downloading QKviews from a BIG-IP. The qkview utility automatically collects configuration and diagnostic information from BIG-IP systems, and combines the data into a QKView file. F5 Support may request you send or upload this QKview to assist in troubleshooting.

Parameters

Parameter Choices/Defaults Configuration Comments
asm_request_log
boolean
    Choices:
  • no ←
  • yes
When true, includes ASM request log data. When False, excludes ASM request log data.
complete_information
boolean
    Choices:
  • no ←
  • yes
Include complete (all applicable) information in the QKview.
dest
path / required
Destination on your local filesystem where you want to save the QKview.
exclude
list / elements=string
    Choices:
  • all
  • audit
  • secure
  • bash_history
Exclude various file from the QKview.
exclude_core
boolean
    Choices:
  • no ←
  • yes
Exclude core files from the QKview.
filename
string
Default:
"localhost.localdomain.qkview"
Name of the QKview file to create on the remote BIG-IP.
force
boolean
    Choices:
  • no
  • yes ←
If no, the file will only be transferred if the destination does not exist.
max_file_size
integer
Default:
0
Maximum file size of the QKview file, in bytes. By default, no max file size is specified.
timeout
integer
Default:
300
The amount of time in seconds to wait for the async interface to complete its task.
The accepted value range is between 10 and 1800 seconds.

Notes

Note

Examples

- hosts: all
  collections:
    - f5networks.f5_bigip
  connection: httpapi

  vars:
    ansible_host: "lb.mydomain.com"
    ansible_user: "admin"
    ansible_httpapi_password: "secret"
    ansible_network_os: f5networks.f5_bigip.bigip
    ansible_httpapi_use_ssl: yes

  tasks:
    - name: Fetch a qkview from the remote device
      bigip_qkview:
        asm_request_log: yes
        exclude:
          - audit
          - secure
        dest: /tmp/localhost.localdomain.qkview

Status

Authors

  • Wojciech Wypior (@wojtek0806)