Diagnostics

iHealth configuration overview

If you have configured your system with F5 iHealth credentials, the iHealth upload feature uploads QKView files, by default, directly to F5 iHealth at ihealth2.f5.com. If the host does not have internet access to reach f5.com, you can configure the system to use a web proxy to upload the QKView file to F5 iHealth.

Configure iHealth credentials and web proxy from the webUI

Before you can log in to the new iHealth system, you must first generate API token credentials at ihealth2.f5.com/qkview-analyzer/settings.

The iHealth upload feature uploads QKView reports, by default, directly to F5 iHealth at ihealth2.f5.com. You can configure iHealth credentials from the webUI. If the host does not have internet access to reach f5.com, you can configure the system to upload QKView files to iHealth using a web proxy server.

  1. Log in to the webUI using an account with admin access.

  2. On the left, click System Settings > System Security

    Expand the iHealth Configuration section to view the iHealth Configuration.

  3. Click the Edit icon to edit the configuration.

  4. In the Credentials area, for Client ID, enter your client identifier.

  5. For Client Secret, enter the secret associated with the client identifier.

  6. Configure a proxy server, if needed.

    Note: If you are not using a web proxy server, leave these fields blank.

    a. In the Proxy Server area, for Server URL, enter the web proxy server URL, including the port number.

    b. For Username and Password, if the web proxy server requires credentials, enter the user name and password.

    Note: If the web proxy server does not require credentials, leave these fields blank.

  7. Click Save.

Now you can generate QKView files and upload them to F5 iHealth.

System reports (QKView) overview

If you have any concerns about your system operation, you can use the QKView utility to generate a system report to collect configuration and diagnostic information from the system. The QKView file contains machine-readable (JSON) diagnostic data and combines the data into a single compressed tar.gz format file. You can upload the QKView file to F5 iHealth at ihealth2.f5.com, where you can get help verifying proper operation of the system, understanding and troubleshooting any issues you might be having, and ensuring that the system is operating at its maximum efficiency.

For information about generating a QKView for BIG-IP Next or other tenants, see the documentation on my.f5.com and clouddocs.f5.com.

Generate system reports (QKView) from the webUI

You can generate a QKView file from the webUI. The report contains diagnostic information, such as configuration data, log files, and platform information.

  1. Log in to the webUI using an account with admin access.

  2. On the left, click System Monitoring > System Reports

    The System Reports screen displays. A list of QKView files that were previously generated are shown with any reports that were uploaded to iHealth.

  3. To generate a system report, click Generate QKView. The Generate QKView drawer form displays these additional options:

    Option

    Description

    Filename

    Specify a name for the file to which QKView file data is written. The default filename is <system-name>.qkview.  

    Timeout Value

    Specify the time in seconds after which to stop QKView file data collection. The default value is 0, which indicates no timeout.

    Max File Size

    Exclude all files greater than the specified size (in MB). The range is from 2 MB to 1000 MB. The default value for maximum file size is 500 MB.

    Max Core Size

    Exclude core files greater than this size (in MB). The range is from 2 MB to 1000 MB. The default value for maximum core size is 25 MB.

    Exclude Cores

    Specify whether core files should be excluded from the QKView file. The default is to include core files.

    		 
      **Note:** The system runs many commands to collect the diagnostic information, so generating the report might affect its performance.

    It takes a few minutes for the system to finish creating the report and list it on the screen. The QKView Status changes to File generated successfully when it is done.

  4. To upload the report to the F5 iHealth server:

    a. Select the check box next to the QKView to be uploaded.

    b. Click Upload to iHealth.

    c. In the Upload to iHealth drawer form, enter your iHealth credentials.

    Optionally, you can include your F5 Support case number and a brief description.

To do the upload, the system must have DNS configured, and have Internet access to these services using the HTTPS/443 remote service/port:

- api.f5.com

- ihealth-api.f5.com

The QKView tar file uploads to iHealth, where you can get help to diagnose the health and proper operation of the system.

  1. To delete a QKView file, select it and click Delete.