IBM Support

Collecting Data: MustGather for AIOps Insights Agent

Troubleshooting


Problem

This technote provides the steps necessary to collect data and logs for IBM AIOps Insights Agent (Linux & Kubernetes or Red Hat OpenShift).

Resolving The Problem

Linux Agent Data Collection:
  • Open Infrastructure map
image-20230822161634-1
  • Open Agent dashboard
        1. Search for the Linux host (for example, entity.host.name:<regex matching host name>), where the agent is running
        2. Click the filtered host
        3. Click Open dashboard
image-20230822162710-4
  • Collect the following details and upload to IBM Support website.
        1. Agent Configuration
image-20230822163231-5
       
        2. Agent logs in DEBUG mode
            Toggle for INFO or DEBUG mode for the agent log is a real-time toggle. If the current Log level is INFO, then change it to DEBUG. Re-create the problem so that we have the appropriate data, or, at least wait a couple of minutes so that the problem re-occurs with the correct data in the log.
image-20230822163432-6
image-20230825124704-1
image-20230822163725-7
       3. Sensors information
image-20230822163935-8
Kubernetes or Red Hat OpenShift Agent Data Collection:
  • Open Infrastructure map
image-20230822161759-3
  • Open Agent dashboard
        1. Search for the Kubernetes / Red Hat OpenShift host (for example, entity.kubernetes.node.name:<regex matching node name>), where the agent is running
        2. Click the filtered host
        3. Click Open dashboard
image-20230822165344-9
  • Collect the following details and upload to IBM Support website.
        1. Agent Configuration
image-20230822165812-10
       2. Sensors information
image-20230822170307-11
3. Agent logs
For Kubernetes or Red Hat OpenShift Agent data collection, we recommend you use the command:
./aiopsinsights-mustgather.sh -DO agent -W 'GMGFVAR_MODE=AGENT'
Once the MustGather tool is executed successfully, upload output data file under the "/tmp/mg" (or directory of your choice through the "-o" option) directory to IBM Support website.
 
IMPORTANT: Make sure to uncompress the downloaded AIOps Insights MustGather package in its own directory (not sharing with any other files or directories).
If you use a terminal for download, the command is:
wget https://www.ibm.com/support/pages/system/files/inline-files/aiopsinsights-mustgather-v0.1.6.tar.gz
NOTE: Download the attached script to any machine that has valid access to the target cluster (able to run 'oc' / 'kubectl' command successfully).

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSSCLP","label":"IBM AIOps Insights"},"ARM Category":[{"code":"a8m3p000000bmRpAAI","label":"Mustgather-\u003EAgent"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
09 October 2023

UID

ibm17028233

Page Feedback