Opsview 6.9.x End of Support
Opsview versions 6.9.x reached their End of Support (EOS) status at the end of January 2026, in accordance with our Support policy. As of this date, these versions no longer receive code fixes, security updates, maintenance releases, or backported changes.
The documentation for version 6.9.7 and earlier releases will remain accessible for reference, but it will no longer be updated or maintained. We strongly recommend upgrading to the latest supported version of Opsview to ensure continued support and access to the latest features and security enhancements.
Config endpoints examples
Updating multiple Service Checks Copied
The restapi can be used to update multiple servicechecks in one go:
-
Obtain the list of check to be modified and store in a file, i.e. all service checks with ‘foo’ in the name.
opsview_rest --username=USER --password=PASS --pretty --data-format=json GET 'config/servicecheck?json_filter={"name":{"-like":"%25foo%25"}}' > checks.json -
Edit the
checks.jsonfile as necessary. -
Import the contents of the file back into Opsview.
opsview_rest --username=USER --password=PASS --pretty --data-format=json --content-file=checks.json --pretty PUT config/servicecheck
Note
The ID’s within thechecks.jsonfile must be left unchanged else new checks will be created, not current checks updated. Amending service check names could lose historical (graphing) information.
Determining if a Host exists Copied
To see if the host foo already exists:
opsview_rest --username=admin --password=initial GET 'config/host/exists?name=foo'
This will return ”{’exists’ ⇒ ‘0’}” if the host does not exist, ”{’exists’ ⇒ ‘1’}” if it does.
Fetching information for a specific contact Copied
To fetch contact information without fetching the ID first
opsview_rest --username=admin --password=initial GET 'config/contact?s.name=admin'
Create a new user Copied
This shows creating a new user with the minimum fields specified while the changelog is enabled:
opsview_rest --username=admin --password=initial put 'config/contact' --data='{"name":"newname","fullname":"New Name","changelog":"New user"}'
Amend a users role Copied
opsview_rest --username=admin --password=initial put 'config/contact' --data='{"name":"newname","role": { "name":"Administrator"}}'