Icon

Comments have been closed on this page. Please use AppMon & UEM Open Q & A forum for questions about this plugin.

The NGINX Plus Monitoring plugin enables monitoring of your NGINX Plus environment. It queries the metrics that are provided by nginx status endpoint (ex. http://demo.nginx.com/status) and writes them into the Dynatrace Performance Warehouse. In addition, it contains example dashboards that show how metrics can be used in Dynatrace.

Name and Version

NGINX Plus Monitoring Plugin v 1.0.0

Compatible with

Dynatrace 6.2+

Author

Konrad Donaiski -

Dynatrace Software

License

Dynatrace BSD

Support Level

Not Supported

Download

com.dynatrace.plugin.nginx_1.0.6.jar

Installation

To import the plugin (  com.dynatrace.plugin.nginx_X.X.X.fast_pack.jar), start the Dynatrace Client, and choose Server Settings menu > Plugins > Install Plugin. Refer to the Dynatrace documentation for installation details.

Plugin Configuration

To start using the plugin after successful installation, right click on the newly created system profile NGINX Plus Monitoring and select Edit System Profile from drop down menu. In the System Profile Preferences dialog, create a new monitor and select the NGINX Plus Monitor from the monitor list.

 

The next dialog lets you configure the details of the monitor (optional). You have to define the host where the NGINX Plus status endpoint is available that serves the metrics in JSON format. Just press the "+" button to create a new host and enter the details. For demo purposes, you can create a demo.nginx.com host, as shown in the screenshot below.

Optionally you can also define a filter for upstreams and streams. For example, 127.0.0.1 to filter on servers that are running on localhost only.

Now let's switch to the Schedule tab. Here you define the run interval of the plugin and set the schedule to 10 seconds.

The Measures tab gives you an overview of all the measures that are subscribed to automatically. You can add additional configuration (e.g. alerting thresholds) if you want to use the traffic light chart in your dashboards. For demo purposes please set the State measure threshold to upper warning=1.0 and upper severe=3.0.

 

Now you can close the measure configuration dialog and click the Apply button, which will store the newly added configuration in the system profile. The monitor should start immediately. You will see an error if the host information you entered is wrong. After making sure that the plugin executes without errors, you can close the system profile configuration.

Dashboards

Now let's take a look at the demo dashboards that were installed by the FastPack. Go to Dashboards > Open to get an overview of the dashboards. If you changed the name of the monitor you will need to add new measures to the dashboards. If you defined the monitor in a different system profile from NGINX Plus Monitoring, you will have to select a new data source for the dashboards.

   

 

  1. Anonymous (login to see details)

    Hi,

    Is HTTPS supported by this plugin? I might have missed out but dont see to find that mentioned in this page.

    We have a customer that implements HTTPS for communication between the app servers and DT collectors, so if HTTPS is not supported, is there a plan to include that in future?

    Thanks

  2. Anonymous (login to see details)

    Hey Hogan, I recently ran into the same issue. I have a pull request in the Github repo: https://github.com/Dynatrace/Dynatrace-NGINX-Plus-Monitoring-Plugin/pulls. You can wait for that to be merged in or add the code yourself manually by checking out the plugin and adding these changes. 

  3. Anonymous (login to see details)

    Is the latest and greatest Plugin or Fastpack, somewhere I can download? I'm a newbie at this, so I rather not try to Check-out or add changes.

  4. Anonymous (login to see details)

    Unfortunately, the change has yet to be pulled in. Here are the steps for compiling it yourself, though! 

    1. Download the latest community version of the NGINX Plus Plugin from https://community.dynatrace.com/community/display/DL/NGINX+Plus+Monitoring+Plugin and save the jar file locally
    2. Open up the Dynatrace Client and navigate to Manage Server > Plugins > Install Plugin
    3. Select the jar that you downloaded, install it and apply the changes
    4. Locate the plugin in the Installed Plugins tab and click the "Checkout" button
    5. Clone the revised version https://github.com/wolfmd/Dynatrace-NGINX-Plus-Monitoring-Plugin to your system
    6. Copy the contents of the cloned directory into the folder that you checked out the plugin. Make sure the src files override those that are already there
    7. Open the Dynatrace client and navigate to Manage Server > Plugins and then select the tab "Plugin Development" near the top.
    8. Select "Open" and select the folder that had been checked out (the one where you had replaced the source code)
    9. Attempt to build the project and fix any errors
    10. Attempt to test the plugin and make sure you get a 100 response
    11. Deploy

    If you're still having problems, shoot me a message at michael.wolf@kroger.com and I can help you through it

  5. Anonymous (login to see details)

    Hi all,

    We have disabled comments on this plugin page.

    Please use the AppMon & UEM Plugins forum for questions about this plugin.

    Sorry to interrupt ongoing discussions. Please re-post your last question in AppMon & UEM Plugins forum.