Quick-Tip: Monitoring Domino V10 with New Relic

Wednesday, October 17, 2018 at 5:11 PM UTC

One feature that was mentioned on slides months ago but wasn’t as prominent as it should be is the built-in monitoring feature of your server with a service called „New Relic“.

This is by far the most simple setup I’ve ever experienced during my 18-year lasting Domino career. It just takes a few simple steps to start:

  1. Create an account at www.newrelic.com - it’s free for the start!
  2. Log in to your NewRelic account (you will get confirmation emails etc.)
    At the top-right of the New Relic window you just select „Account Settings“
  3. In the right pane you can see your license key. Copy this to the clipboard
  4. On each server that you want to report statistics to New Relic add the
    following Domino notes.ini setting: NEWRELIC_LICENSE_KEY=<key>
    where <key> is the NewRelic license key just copied from their web page

Regardless you added this variable manually or via a configuration document you have to restart the server of course.

The server should start to send stats data automatically after a few minutes without restarting. Thanks Andy Brunner for the hint!

To open the DominoStats plugin, from New Relic click Plugins and then
DominoStats. 

New Relic offers a dashboard which covers all the stats of your Domino server. There is also a mobile app to monitor when you are on the go.






Latest comments to this post

Manuel Nientit wrote on 24.10.2018, 11:50

Hi Oliver,

Yes, I find it strange too. IBM/HCL advertise this as a cool new feature and seem to have put some effort into the connection specially for newrelic - and now it does not work for a huge part of the customership...?

 Link to this comment
Oliver Busse wrote on 24.10.2018, 11:26

Manuel,

this is strange. I have my key since beta 1, which means since the end of June. So they obviously changed something (also discussed with Lars), the new keys also looks different from the one I use.

 Link to this comment
Manuel Nientit wrote on 24.10.2018, 11:17

I was also testing newrelic, but I fail the same way Lars does.

I am now told by the community moderator that Plugins are not supported for EU, which means that the Domino Interface to NewRelic does not work for EU - in my case and judging from the name in Lars's case also - germany.

Here is a doc mentioning that:

https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/getting-started/introduction-eu-region-data-center#regions-availability

Well there should be other services... :(

Hopefully this info helps some people save some time.

 Link to this comment
Oliver Busse wrote on 21.10.2018, 17:52

Lars, I sent you an email which I got back after a few hours as "undeliverable". Contact me under kontakt[at]oliverbusse[dot].com

 Link to this comment
Mike Gagnon wrote on 20.10.2018, 00:07

Lars,

Oliver is correct - the error you are getting indicates the license key is not valid.  Log into your New Relic account and compare the key value with the one specified in the notes.ini file (which is also written out the log).  Make sure the values are exactly the same.

 Link to this comment
Lars Pflanz wrote on 19.10.2018, 11:47

Oliver, could you please connect me via e-Mail for other questions?

Thanks

 Link to this comment
Lars Pflanz wrote on 18.10.2018, 14:31

Sorry, there are no space characters. I think the problem are:

Failed to POST metric data using URI: 'http://platform-api.newrelic.com/platform/v1/metrics'; Unable to load specified URL

Metrics POST response: HTTP/1.1 403 Forbidden

 

 Link to this comment
Oliver Busse wrote on 18.10.2018, 13:24

Lars, the error is very clear about it: "invalid license key". My guess is you missed a character or you have a leading (or trailing) space in the key.

 Link to this comment
Lars Pflanz wrote on 18.10.2018, 11:49

Notwithstanding right key i get error message on Domino conole: Any have tips for me?

StatPubFlushPostData> Failed to POST metric data using URI: 'http://platform-api.newrelic.com/platform/v1/metrics'; Unable to load specified URL.
StatPubFlushPostData> Metrics POST headers:
X-License-Key: xxxxxxxxxxx
Content-Type: application/json
Accept: application/json

StatPubFlushPostData> Metrics POST response:
HTTP/1.1 403 Forbidden
Content-Length: 32
Date: Thu, 18 Oct 2018 09:40:55 GMT
Content-Type: text/plain; charset=utf-8
X-Cnection: close


{"error": "Invalid license key"}
Warning: ODSLookupBufferToOrFrom32: Error 60A, please set the notes.ini variable DEBUG_NAMELOOKUP for more information.

 Link to this comment
Andy Brunner wrote on 18.10.2018, 07:39

Small correction: No Domino server restart is necessary. After a few minutes, the statistics are sent automatically to New Relic.

 Link to this comment

Leave a comment right here