Skip to content
This repository has been archived by the owner on Oct 29, 2020. It is now read-only.

newrelic/infra-integrations

Repository files navigation

New Relic Infrastructure Integrations

DEPRECATION NOTICE AND UPGRADE INSTRUCTIONS

This package was created at a time when New Relic Infrastructure was just starting with a reduced number of developers. The decision to use a single package for installing all our integrations, and a mono-repository to host the code, was something that made sense at the time; however, now the circumstances are very different, we have significantly increased the number of integrations and the people working on them, which made us switch to an approach based on individual repositories and packages per integration, this allows us more control, faster delivery, it's easier to maintain and causes less errors.

Since version 2.0.0 this package will be empty and no integrations will be installed.

If you're still using this package, we advise you to follow the NewRelic docs on how to uninstall integrations; basically:

  • Debian/Ubuntu:
    1. sudo apt-get remove newrelic-infra-integrations
    2. sudo apt-get autoremove
  • CentOS/RHEL/Amazon:
    1. sudo yum remove newrelic-infra-integrations
    2. sudo yum autoremove
  • SLES:
    1. sudo zypper -n remove newrelic-infra-integrations --clean-deps

Then, follow the NewRelic docs on how to install integrations to install the individual integrations you need, keep in mind that the change should be transparent, your configuration files won't be deleted by uninstalling this package and will be valid for the individual packages.

END OF DEPRECATION NOTICE AND UPGRADE INSTRUCTIONS

New Relic Infrastructure, provided by New Relic, Inc (http://www.newrelic.com), offers flexible, dynamic server monitoring. This package contains the set of official integrations supported by New Relic, built to provide the essential metrics and inventory for monitoring the services. That data will be findable and usable in New Relic Infrastructure and in New Relic Insights. You can find more information on how to access and visualize that data on our docs site.

This repository serves as an aggregator where you can find each of our integrations as submodules under the integrations/ directory, you'll find more information about them in the following section. Previously this was a mono-repo that hosted the source code of the integrations, but as the number of integrations grew we move them to their own repositories.

The Integrations Golang SDK is hosted on github.

Compatibility and requirements

Up-to-date our docs site.

Official Integrations

To find more information about our integrations, how to configure and use them with New Relic, refer to their documentation pages or the README included by each of them:

Integration Documentation Readme
Cassandra doc readme.md
MySQL doc readme.md
NGINX doc readme.md
Redis doc readme.md
Apache doc readme.md

To download this repository with the integrations as submodules run:

git clone --recurse-submodules https://github.com/newrelic/infra-integrations.git

Contributing Code

We welcome code contributions (in the form of pull requests) from our user community. Before submitting a pull request please review these guidelines.

Following these helps us efficiently review and incorporate your contribution and avoid breaking your code with future changes to the agent.

Custom Integrations

To extend your monitoring solution with custom metrics, we offer the Integrations Golang SDK which can be found on github.

Refer to our docs site to get help on how to build your custom integrations.

We also provided a command line builder tool for creating and scaffolding new integration in Golang. This will generate the project structure and include the dependencies needed (including the sdk) for creating your custom integrations.

Support

You can find more detailed documentation on our website, and specifically in the Infrastructure category.

If you can't find what you're looking for there, reach out to us on our support site or our community forum and we'll be happy to help you.

Find a bug? Contact us via support.newrelic.com, or email support@newrelic.com.

New Relic, Inc.