Troubleshoot ITSI permissions, teams, backups, and restores
Here are some common issues related to ITSI permissions and capabilities, backups, and restores and how to resolve them.
User assigned a custom role can't view objects
A user is assigned a custom role can't view objects in ITSI
Make sure you've fully completed steps 1-4 in Create a custom role in ITSI.
User has itoa_admin role but can't view objects
A user is assigned the itoa_admin role but is unable to read services or any other objects on their corresponding lister pages.
By default, the itoa_admin role ships with the itoa_analyst and itoa_user roles. The itoa_user ships with read capabilities for ITOA objects like services, entities, glass tables, and deep dives. Make sure these capabilities haven't changed.
Unable to create an external ticket
A user is assigned the itoa_analyst role with the create_external_ticket capability. However, they're unable to create an external ticket.
A restriction in Splunk Enterprise means the user needs the itoa_admin role, which inherits from the admin role.
"Access denied. You do not have permission to create this object."
You see access denied errors when attempting to create objects.
ITSI relies on the fact that your admin role inherit from the roles defined in $SPLUNK_HOME/etc/apps/itsi/default/authorize.conf:
[role_admin] importRoles = itoa_admin;itoa_analyst;itoa_user;power;user
Use btool to check system/local/authorize.conf:
$SPLUNK_HOME/bin/splunk btool authorize list role_admin --debug
You might have redefined the admin role inheritance in system/local/authorize.conf, or in other apps. If this is the case, add the inheritances added from the UI or through the configuration file.
Default scheduled backup not running
After a fresh install or migration, the default scheduled backup isn't running at 1:00 am.
The backup runs at 1:00 am in the timezone of the server. If your local timezone is different than the server's, it might appear to run at a different time.
Alternatively, the modular input for the default scheduled backup runs at every restart, and every hour after that. It's possible to see a maximum of one-hour delays. For example, if the next scheduled time is 1:00am, the modular input runs at 12:45am and 1:45am, the backup will start at 1:45am.
Failed to fetch backup information preview
ITSI fails to fetch backup information preview with ID: <backup_id>
https://localhost:8089/servicesNS/nobody/SA-ITOA/backup_restore_interface/backup_restore/preview/<backup_id> and see if the information exists for the given backup ID.
Failed to upload a backup file
ITSI fails to upload the selected backup file.
- Check the network tab of the browser to see if there's a failed request. Check if you can create a restore job by clicking Create.
- Make sure the file is valid and not corrupted.
- Get a new backup file from the backup job. Download this file and try to upload it for restore.
Global team is gone after upgrade
The global team is no longer present after an ITSI upgrade.
All services in ITSI must be assigned to a team. If migration fails with the error
Failed to import Team settings, you can manually run the Python script called
itsi_reset_default_team.py. The script manually creates the Global team in the KV store which completes the migration.
To run the script, perform the following steps:
- Run the following commands on any search head in your ITSI deployment:
cd $SPLUNK_HOME/etc/apps/SA-ITOA/bin $SPLUNK_HOME/bin/splunk cmd python itsi_reset_default_team.py
- Provide the splunkd port number and your Splunk username and password when prompted.
After the script finishes successfully, the Global team is created in the KV store.
- Restart your Splunk software.
Check the ITSI logs
IT Service Intelligence log files have a prefix of
- IT Service Intelligence search command logs are located in
- All other ITSI logs are located in
All ITSI logs have a source type of
itsi_internal_log to make them easy to search.
- Run the following Splunk search to search ITSI logs:
index = _internal sourcetype=itsi_internal_log
- Click the source field under Selected Fields to see specific log files.
For Windows deployments, the ITSI search command log,
itsi_search.log, cannot be searched in Splunk Web. You must open the file on the Windows host using a text editor.
Notable Event Actions SDK reference
This documentation applies to the following versions of Splunk® IT Service Intelligence: 4.0.0, 4.0.1, 4.0.2, 4.0.3, 4.0.4, 4.1.0, 4.1.1, 4.1.2, 4.1.5, 4.2.0, 4.2.1, 4.2.2, 4.2.3, 4.3.0, 4.3.1, 4.4.0, 4.4.1, 4.4.2, 4.4.3, 4.4.4, 4.4.5, 4.5.0 Cloud only, 4.5.1 Cloud only, 4.6.0 Cloud only, 4.6.1 Cloud only, 4.6.2 Cloud only, 4.7.0, 4.7.1, 4.7.2, 4.7.3, 4.7.4, 4.8.0 Cloud only, 4.8.1 Cloud only, 4.9.0, 4.9.1, 4.9.2, 4.9.3, 4.9.4, 4.9.5, 4.9.6, 4.10.0 Cloud only, 4.10.1 Cloud only, 4.10.2 Cloud only, 4.10.3 Cloud only, 4.10.4 Cloud only, 4.11.0, 4.11.1, 4.11.2, 4.11.3, 4.11.4, 4.11.5, 4.11.6, 4.12.0 Cloud only, 4.12.1 Cloud only, 4.12.2 Cloud only, 4.13.0, 4.13.1, 4.14.0 Cloud only, 4.14.1 Cloud only, 4.14.2 Cloud only