Troubleshoot Unknown Status of Tableau Server Processes
Under certain conditions you might see that the status of a Tableau Server process as reported as Unknown. This is often due to a change in the process configuration in Tableau Server which has not yet been updated in Tableau Resource Monitoring Tool.
Note: After updating any configuration, it may take a few minutes for the status reported by the Resource Monitoring Tool to refresh. By default, the Resource Monitoring Tool checks the Tableau Server status every 15 seconds but it may be longer if you configured it to check less frequently.
Use the following troubleshooting steps to resolve this issue:
Step 1: Check Tableau Server Environment Settings
The Resource Monitoring Tool connects to Tableau Server for monitoring and data collection. If the Tableau Server is upgraded, or the Tableau Server credentials expire then Resource Monitoring Tool will not be able to monitor it as expected.
To confirm that theResource Monitoring Tool is able to connect to your Tableau Server:
- Go to Admin > Environments list page.
- Edit the environment that is having the issue.
- Confirm that the selected Tableau Server version is correct. When you upgrade your Tableau Server you may need to update the version in the Resource Monitoring Tool.
Test the Tableau Server REST API connection using the “Test Connection” button.
Optionally, test the Tableau Repository connection using the “Test Connection” button.
Step 2: Update Tableau Server Machines and Processes
To correctly monitor a Tableau Server, the Resource Monitoring Tool needs to be configured with a complete record of your Tableau Server machine names and process ports. This information is automatically gathered when creating a new environment but may need manually updated if the Tableau Server configuration is changed.
- Go to the Admin > Environments page.
- Edit the environment that is having the issue.
- Confirm that the list of Servers contains your initial node/gateway Tableau Server machine as well as all additional node machines.
- Follow the steps below to confirm that each server is configured correctly.
Step 3: Update Machine Name
- Open this Tableau Server URL: http://<your TableauServer URL>/admin/systeminfo.xml.
- Compare and update the Resource Monitoring Tool configuration with this page to ensure it is up-to-date:
- Update the server’s Host Name to exactly match the <machine name="{HOST NAME}" /> attribute value.
Step 4: Contact Support
If, after following the above steps the issue is still not resolved, contact Tableau customer support(Link opens in a new window).
VizQL Session details page says the VizQL process is unknown
HTTP requests for a Tableau view are linked to the VizQL process (the actual VizQL PID) that last locked the request’s VizQL session ID.
In some cases we may not be able to find a matching VizQL process (PID) and in these cases you will see a message on the view session details page that the VizQL process is unknown.
This can happen in a few rare cases:
- The Tableau cluster has been modified with the addition of a new VizQL worker instance.
- Tableau adjusting the VizQL process’s port number to avoid a conflict with another process.
If this happens, sign in to the Resource Monitoring Tool and navigate to the environment admin screen. You’ll want to check the process definitions for your servers. Ensure that VizQL processes are defined on the expected servers and with the correct port numbers.
To troubleshoot Tableau Server processes issues, you need to be both a Tableau Server Administrator and a Resource Monitoring Tool Administrator.