Jump to content

Let's start discussing about possible usage of Domotz Public API


Recommended Posts

As you might be aware, in Q4 2018 we opened our cloud-based RESTful API to the public to be used by Domotz Users to get information out of our cloud or update configuration or more.

 

Any developers has now have an easy and comprehensive way to integrate third party applications with the Domotz Pro solution for several purposes. E.g.:

 

  • Custom Dashboards: you can build your own dashboard to show the status of all the devices you are monitoring for your customers, and you can enrich it with your own data
  • Asset Management: you can build your own Asset Management tool. In an instant, you can retrieve the enriched list of all the devices online/offline in any single network you monitor and manage through Domotz
  • Customized Reports: create your customized reports and provide them to your customers. You can create and host on your servers script to extract data out of Domotz and prepare PDF or XLS sheet you can finalize with your own data
  • Identify the most trouble device: create your custom script to extract the most troubled devices among all your Agents for example by identifying which one drops out of the network the most often
  • self-healing script: write your own script that reboot a device (either through the connected PDU or PoE port of the switch, or through soft reboot) in the case it is discovered offline
  • much more: the only limit is your imagination

 

We will use this area of the forum to post open source code, developed using the Domotz Public API and to get feedback on those.

 

Please, use this section also to ask questions or advices on how to best use the Domotz Public API for your specific use cases.

 

For reference, Documentation related to the latest version of the Public API is available here.

  • Like 1
Link to post
Share on other sites

First of all, thanks very much for this!

 

I would love to be able to do a REST streaming call which would return device status changes (JSON) as they happen.  This is better for both sides, since it's a nailed-up connection, we avoid the overhead of connection setup and time delay between polling cycles.  

  • Like 1
Link to post
Share on other sites
  • 6 months later...
On 9/6/2019 at 10:20 AM, Rolf said:

Any chance you could use this API to output configurations to ITGlue for documentation of client sites?

 

Absolutely: you can use the List of Device API or the Device Details API to get information out of the Domotz Pro cloud and then import into ITGlue.

 

We also have users who have used the Export in XLS functionality (available from the WebApp) and then imported the data into ITGlue.

 

In any case, it is worth to mention that we are trying to get in contact with the ITGlue team to have a proper integration between the two systems. On this matter, if you have a good contact in ITGlue, please send me a Private Message.

On 2/12/2019 at 11:06 AM, emes said:

First of all, thanks very much for this!

 

I would love to be able to do a REST streaming call which would return device status changes (JSON) as they happen.  This is better for both sides, since it's a nailed-up connection, we avoid the overhead of connection setup and time delay between polling cycles.  

 

It is possible to get notification of status changes of the devices by using WebHook as a Contact Channel for alert.

 

https://domotzpro.tome.host/tc/14140

 

Therefore, you can configure a Shared Alert with WebHooks (which points to your web server to receive notification), and then setup the Alert on the Devices and Agents for which you would like to receive a device status change notification.

Link to post
Share on other sites
  • 1 month later...

Is it possible to add tiles to the Domotz interface?

Add extra buttons/links per device?

I have additional information I gather per device that I would like to link to but not create a whole other user interface.

 

Link to post
Share on other sites
23 hours ago, 22Element said:

Any update on ITGlue integration? How about Connectwise Manage for downtime/uptime ticket creation and solve? Would be a great add at our clients

 

We are in contact with the Product Management at ITGlue. The integration is more on their side (given that it is already possible to use the Domotz Public API to retrieve data and then import into ITGlue), but we will also see if we can do the integration in Domotz (for an initial update of custom data). It is on our priority list of developments.

 

In any case, it would be beneficial, if you have contacts in ITGlue (or through the Community forum) to stimulate this type of discussion.

 

With regard to ConnectWise Manage, this is on our roadmap to start development before the end of the year. On a similar integration, in the next few weeks we should be able to release the integration with Zendesk (soon after we will work on the ConnectWise Manage for the ticket creation and updates.

  • Like 1
Link to post
Share on other sites
15 hours ago, GregS said:

Is it possible to add tiles to the Domotz interface?

 

We have discussed this internally. The idea we had about the "Custom Tile" is to allow the user to group within that Tile different devices (user is free to chose his/her rules). We don't have yet this in our roadmap, but it is in the backlog of activities to be developed in the future.

 

15 hours ago, GregS said:

Add extra buttons/links per device?

I have additional information I gather per device that I would like to link to but not create a whole other user interface.

 

On the other hand, this is something different which is already in our Roadmap. By beginning of 2020, we should be able to release the capability of allowing users to write their own drivers, to extract data (arbitrarily) out of the device, and make those information available through the Domotz App/WebApp UI. Stay tuned on this.

 

Finally, it is worth to mention that at the moment, using the Public API, it is already possible to:

 

- create custom fields to attach to Devices or to Agent entities (as global per the account)

- add, edit and delete the values to any Device / Agent belonging to that account

 

The Custom Field which you can add with the above API are not available through the Domotz App/WebApp yet, but can only be consumed through Public API calls. If you are interested in this, drop me a private message, and I would be happy to explain more.

 

 

Link to post
Share on other sites
  • 1 month later...

I have used the API to set up InfluxDB with Grafana to log and graph long term trends of our internet speed tests past the 1 month data retention you have.  Plus use the Grafana dashboard to show key information at a glance.

 

It would be great to extend the API to allow reading traffic history of select interfaces on devices in the same way we can query 'getspeedtesthistory'.  For example; to log the throughput of a firewalls WAN interface or a core switch.

 

Happy to test any beta API's

 

Keep up the great work; 

 

  • Like 1
  • Upvote 1
Link to post
Share on other sites
  • 2 weeks later...

We are just about to realese the integration with Zendesk (the first one with a ticketing system). The following ones shoud come quicker. The idea is to have by the end of February Datto PSA and Connectwise Manage

Link to post
Share on other sites
  • 1 month later...
Giancarlo
On 2/6/2020 at 7:33 PM, GregS said:

We are a Connectwise user as well.. Can't wait to see that integrated.

 

 

Hi Greg,

 

we are completely on track to release the integration with Datto/Autotask PSA by the end of February. The integration with ConnectWise Manage is coming just after this.

Link to post
Share on other sites
  • 3 weeks later...
Giancarlo
On 2/8/2020 at 5:43 AM, Giancarlo said:

 

Hi Greg,

 

we are completely on track to release the integration with Datto/Autotask PSA by the end of February. The integration with ConnectWise Manage is coming just after this.

 

I just wanted to update this thread and announce that we last week we have released the integration with Datto/Autotask PSA. Some information in the release notes:

 

 

Videos and a blog post will come soon.

 

  • Like 1
Link to post
Share on other sites
  • 4 weeks later...
  • 1 month later...
benphillips
On 3/23/2020 at 2:57 PM, Silvio said:

Connectwise Manage integration is under development, We aim to release it around mid April

 

Any update on the release of the Connectwise Manage integration?  Thanks!

Link to post
Share on other sites
Silvio

Development is completed. We are just waiting for some confirmations from the Connectwise team, before pushing in production.

It should come very soon.

  • Like 2
Link to post
Share on other sites
GregS

And Public API so we can create links from an Agent to something else? I just want to be able to click on a Agent related link and have it launch in a browser somewhere.. 

Link to post
Share on other sites
Giancarlo
3 hours ago, GregS said:

And Public API so we can create links from an Agent to something else? I just want to be able to click on a Agent related link and have it launch in a browser somewhere.. 

 

If I understood correctly, this is what you are trying to achieve. A link that brings you directly into the Domotz WebApp to a specific Agent. If this is correct, this is now available in the following format:

 

https://portal.domotz.com/webapp/#/agent/AGENT_ID

 

or to access directly to a specific Device:

 

https://portal.domotz.com/webapp/#/agent/AGENT_ID/device/DEVICE_ID

 

You can get the specific AGENT_ID and/or DEVICE_ID from the URL on the WebApp, or using the Public API.

Link to post
Share on other sites
ConR

I'm with MarkB on this, do you have a roadmap or plan to extend the Network Statistics for interfaces to the API? Would it be better for us to generate Eyes on the Oid's and interfaces we want to monitor specifically? I write custom reporting / dashboards for our customers, and I integrate with other TimeSeries databases, and it would be nice to have this be able to dump into my Database, where I could then graph that historical data with tools like Grafana, or my own custom JS without having to expose the Domotz. It's great to have one tool actually doing the snmp scraping to keep device load down.Thanks for a clean product! 

  • Like 2
Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

×
×
  • Create New...