Go language integration tutorial and build tools

The New Relic Infrastructure Integrations SDK lets you build an integration for reporting custom host or service data to your New Relic account. This document explains the build tools and resources available for building a Go language Infrastructure integration.

If you've created an integration before October 2018, see SDK changes to understand recent SDK changes and how to update your integration.

Integrations tutorial

The Go language integration-building tutorial on GitHub gives step-by-step procedures for building a Go language integration that reports Redis data.

The tutorial shows how to build an integration using the Linux command line, but you can use the same techniques for a Windows integration with a standard Go install and PowerShell. The make command will not work with PowerShell, but you can use the Go commands inside it as a guide for building your integration.

You can create an integration in any language, but Go is the language New Relic uses for its own integrations and build tools. To create an integration in another language, adhere to the integration file structures and JSON output requirements.

Go language integration building package

The tutorial relies on a New Relic Go language integration-building library package, which provides a set of useful Go functions and data structures. The package gives you tools that:

  • Generate a "scaffold" integration structure with all the required fields.
  • Read values from command-line arguments or environment variables.
  • Generate and print JSON data to stdout.

For general information about integration file formats and JSON output specifications, see:

For more help

Recommendations for learning more: