NetXMS Support Forum

Hi,

NetXMS actually has two web API options available:

• New Web API - Enabled by adding Module = webapi to your configuration. This is the modern API that we're actively developing and expanding. While it currently has limited functionality, it includes a dedicated Grafana endpoint that's specifically designed to work well with the Grafana Infinity plugin and requires less data parsing/modification on the Grafana side.
• Legacy Web API - The older netxms-websvc-VERSION.war service. This has more complete functionality currently but may require more data manipulation when using with Grafana plugins.
  

Since you're using the Grafana Infinity plugin, which can work with any web API, you have flexibility here. You can use either the new API, the legacy API, or even both depending on which is easier for your specific use case.
For new integrations, I'd recommend trying the new Web API's Grafana endpoint first as it will provide the smoothest experience with the Infinity plugin. However, if you need functionality that isn't yet available in the new API, the legacy service is still a viable option.

Question 2 (inputFields Format):

You're right that the documentation needs correction - I apologize for the confusion. The inputFields parameter should be formatted as a JSON object with key-value pairs, not as an array.
Correct format:
{
   "rootObjectId": 2,
   "queryId": 1,
   "inputFields": {
       "name": "value",
        "anotherField": "anotherValue"
    }
}
The code extracts these fields as a StringMap and supports multiple data types:

Strings (used as-is)
Integers (converted to string representation)
Floating-point numbers (converted to string representation)
Booleans (converted to "true"/"false" strings)

I'll update the documentation to reflect the correct format. Thank you for catching this issue!

Try "regex" instead of "useRegex" like:
{{host}}/objects?parent=4&class=interface&regex=true&name=%2F.%2AWI.%2A%2F

There is new blog post about Grafana/NetXMS integration. Maybe object queries might help you with interface display options.
Post:
https://netxms.com/blog/grafana-configuraiton-in-netxms

Hi. Happy that I helped you.

For DCI data please check this request:
https://netxms.org/documentation/adminguide/rest-api.html#dci-values

This is my example of configuration:
URL: http://10.5.5.111:8000/v1/objects/108/data-collection/183/history
UTL query params:
   timeFrom $__from/1000
   timeTo $__to/1000
Root: values


For status map I'm not sure how it can be created with help Ifinity plugin but check API that returns array with objects: https://netxms.org/documentation/adminguide/rest-api.html#get-multiple-objects-with-filters

The only option for maps as for now is to create link in NetXMS that afterwards will be used in IFrame plugin to insert it to the dashboard.

We just published second patch release for version 5.2. It addresses few important issues found in 5.2.1. Full change log is following:

-  Fixed insert into table "notification_log" for TimescaleDB
-  Improved client performance, by disabling alarm refresh if tab is not active
-  Fixed missing DCI on network map links when new DCI's are added on alreay opened map
-  Added job progress indication within views
-  Fixed NXSL get web service document functions
-  Added Grafana Infinity plugin web API endpoints
- Fixed issues:
  -  NX-2733 (Do not show zone column in discovery targets if zoning is off)
  -  NX-2742 (Add NXSL node object method for enabling/disabling SM-CLP polling)
  -  NX-2751 (Delete scheduled tasks on node deletion)
  -  NX-2752 (Add ICMP response time jitter internal DCI for ICMP response statistic collection)
  -  NX-2754 (Separate error code for situation when TCP proxy is not enabled in agent config)
  -  NX-2755 (NXSL Interface utilization values returned as int, without decimal point)
  -  NX-2764 (Add PostgreSQL 17 support in monitoring subagent (pgi_stat_checkpointer))
  -  NX-2765 (Increase command length in package manager)

First endpoint also just works without Grafana plugin (it just provides data in human readable way).

Hi,
There are two options.

Our old Grafara plugin had it's own data point (that is still present and works): 
/grafana/alarms
Call examples:
/grafana/alarms - gives object id to object name 
/grafana/alarms?targets=[{}] - will return all alarms
grafana/alarms?targets=[{"alarmSource":{"id":108}}] - to get alarms for object with id 108
You can add as many elements with required object ids in array needed: [{"alarmSource":{"id":108}}, {"alarmSource":{"id":512}}, ...]
 
Another option is to add parameter resolveReferences=true to webapi/alarms request like: http://x.x.x.x:8080/webapi/alarms?resolveReferences=true 
This parameter adds full information about alarm source node, source event name and names of users if possible to resolve. 

Hi,
Yes you can use link styling script. 
Here you can see example that I use for automatic integration tests: https://github.com/netxms/netxms/blob/master/tests/integration/src/test/resources/networkMapStylingScript.nxsl
Basically you should get STP status form $link.object1 nad $link.object2 (It will be NetObjects or Nodes connected by the link https://netxms.org/documentation/nxsl-latest/#class-node )
and set color with help of:
$link.setColorConfig(MapLinkColorSource::CustomColor, "#FF00FF");

Hi folks! Today we're having the last NetXMS Talks webinar of the year (15:00 Riga time). This time we'll cover:
- New automatic map type, or so-called "hybrid topology"
- New object class — "Circuit"
- Peer information on interfaces that now can be set and cleared manually
- Writing your comments using Markdown for more readability
.. and, as usual, we'll be happy to take your questions! Yes, there will be a recording afterwards. To join just follow link: Event connection link

Hello Everyone! This week, from Friday to Sunday, there will be an opportunity to meet us at the NetXMS exhibition booth on Ubuntu Summit 2024 in the Hague. Welcome everyone who happens to be there for a chat about monitoring (and a taste of local chocolates).

Hi.
I created and issue you can track: https://track.radensolutions.com/issue/NX-2593

Will be included in next relese 5.1 

Hi,

Confirmed as a bug for web: https://track.radensolutions.com/issue/NX-2569

Tatjana 

Sorry it's my bad. I read SNMP instear of SMTP. SMTP is supported and should work.
DCI configuration should look like: NetworkService.Status(smtps://domain.org, [email protected], [email protected])

From is optional named parameter, default value is taken from subagent configuration and with no changes will be "[email protected]".
In order to debug problem you should increase debug level to 6 on agent that collects this value. You can increase debug only for "netsvc" debug tag. In my case I had error like this, having 5 as a result of DCI:
2024.08.26 17:39:01.212 *D* [netsvc            ] NetworkServiceStatus_SMTP(smtps://domain.org): call to curl_easy_perform failed (55: RCPT failed: 554)

In Service configuration as an object you should set destination e-mail as Request data. And you can debug errors in the same way as with previous one by increasing debug level on the agent. You will get errors like: 
2024.08.26 18:06:52.008 *D* [netsvc            ] CheckSMTP(smtp//127.0.0.1:465): call to curl_easy_perform failed (7: Failed to connect to 127.0.0.1 port 465 after 0 ms: Couldn't connect to server)

Alarm key can be the same as most probably you have either toner or others and it is not required to make distinction here as they can't coexist
simultaneously for the same device.