Troubleshooting

To collect and send information to Tanium for troubleshooting, collect log and other relevant information.

Collect logs

The information is saved as a compressed ZIP file that you can download with your browser.

  1. From the Discover Home page, click Help , then the Troubleshooting tab.
  2. Click Collect.
    A discover-support.[timestamp].zip file downloads to the local download directory.
  3. Attach the ZIP file to your Tanium Support case form or send it to your TAM.

Tanium Discover maintains logging information in the discover.log file in the <Module Server>/services/discover-service-files/discover.log directory.

View Discover scan ranges

You might want to see the ranges that are scanned before you run discovery, or to troubleshoot discovery that has already run. To see the calculated gaps between the managed interfaces, use the Discover Scan Range and Discover Scan Range - Unix sensors. The Discover Scan Range - Unix sensor is for Solaris and AIX platforms.

For example, you might use the question: Get Computer Name and Operating System and Tanium Client IP Address and Discover Scan Range and Discover Scan Range - Unix from all machines. The results display the range between each of the managed endpoints and its forward and backward peers.

Problem: No results from running a scan

To return results, Discover tools must be distributed to the endpoints. If you do not see results:

  • Check the configuration of the Discover action group. See Configure Discover action group.
  • Check the status of the Discover action group. From the main menu, go to Console > Actions > Scheduled Actions.

Problem: Some endpoints are not scanning

You might find that some endpoints are not scanning. For example, the question: Get Discover Last Scan Range from all machines returns [no results].

Try adjusting the Start at time of the scheduled action to a few minutes after the Start Time of the configured scan window in the profile.

  1. Get the start time of the start window for your profile. From the Discover menu, click Profiles. Hover over the profile_name and click Edit . In the Scan Window section, note the value of the Start Time setting.
  2. From the Main menu, go to Console > Actions > Scheduled Actions. Click the Tanium Discover action group.
  3. Select the scheduled action that is associated with the profile. Choose Discover Content - Execute Scan [profile_name] or Discover Content - Execute Scan for non-Windows [profile_name]. Click Edit.
  4. Edit the Start at time to start a few minutes after the Start Time you found in your profile.

Problem: Extra action groups

If you upgraded from a previous version of Discover, action groups might remain if the permissions on the account that did the upgrade did not have access to remove the old action groups.

Delete old action groups

In Discover 3.0 and later, profiles use the Tanium Discover action group. If you have other Discover action groups, you can remove them.

  1. From the Main menu, go to Console > Actions > Scheduled Actions.
  2. Delete the empty action groups. Delete the following groups: 
    • Discover ARP
    • Discover Connected to All
    • Discover NMap
    • Discover Ping

    Click the action group name. Verify that no actions are associated with the action group. Click Delete, then click Delete Action Group.

    The Tanium Discover action group is used with Discover 3.0. Do not delete this action group.

FAQ: Why is the number of managed interfaces higher than the system status?

If you compare the number of managed interfaces in Discover, you might notice that the number is often higher than the number of Tanium Clients that are reported on the System Status page.

This disparity is expected. Interfaces are unique MAC addresses. One Tanium Client with multiple network interface controllers (NICs) displays as multiple interfaces in Discover. Virtualization software can increase the number of interfaces reported for a computer, if the computer has multiple virtual machines running.

Monitor and troubleshoot endpoints managed

The following table lists contributing factors into why the Endpoints Managed (%) metric might be lower than expected, and corrective actions you can make.

Contributing factor Corrective action
Installation Method Gap
  • Use existing tools that are already part of the infrastructure.
  • Use standard tools (might only cover a subset of potential systems in your environment) such as:
    • SCCM - easy deployment mechanism (Windows only)
    • Group Policy - with the correct setting can deploy Tanium Client (Windows only)
    • Salt - a common tool used for installation of software in any environment (cross-platform)
  • Use a Tanium-provided installation method such as Tanium Client Management
Credential Gaps Use of any of the Tanium-provided installation methods involves using credentials to access the systems. Work with various management teams and deployment teams to understand what credentials are available to do installations on systems. Work with server or workstation support teams to understand these areas.
Network Gaps Installing clients on "protected" networks such as DMZs or other sensitive areas is often a problem. These issues are technical, but the technical hurdles are generally an issue with policies and permissions. Work with the correct stakeholders to understand how Tanium will be used in the environment. Negotiate restrictions to be lessened to allow installation of Tanium Clients in these protected networks.

Monitor and troubleshoot mean time to manage

The following table lists contributing factors into why the Mean Time to Managed (hours) metric might be higher than expected, and corrective actions you can make.

Contributing factor Corrective action
No automation Tanium Discover can find clients, but with no action, a project can stall. Automating installation with Discover labels to target installation with Tanium Client Management is key. Take the human interaction out when possible, or build a workflow around Discover labels when items are found to feed into Tanium Connect and create help desk tickets or simple email lists.
Non-optimized Discovery settings
Regional Ownership

Often various regions have different support structures in the larger enterprise. Understanding what systems belong to these regions is key to providing the guidance to the owning team they need to help install. Use locations to export or visualize data. See this three-part article:

Understand your environment Proper deployment sometimes requires understanding what is working and what is not working. With the data grids and graphs in Discover, you have a real-time view the environment. With a high level view over time, you can understand how deployments are working and cross-pollinate various ideas that work across a larger group. To get a high level view, use the Discover boards in Tanium Trends: Tanium Community article: Use Trends to visualize Discover interfaces over time.

Uninstall Discover

  1. From the Main menu, click Solutions. Under Discover, click Uninstall. Click Proceed with Uninstall to complete the process.
  2. Delete any remaining Discover-related scheduled actions and action groups. For more information, see Tanium Console User Guide: Delete an action group.

  3. Check for Discover artifacts on your endpoints. Ask the question: Get Has Discover Artifacts = "true" from all machines. If any endpoints are returned by this question and you want to clean the artifacts off the endpoint, contact your TAM.
  4. Check for Discover plugin schedules. From the Main menu, go to Console > Configuration > Common > Plugin Schedules. If plugin schedules exist for Discover, contact your TAM.