To set up and configure the New Relic API, start by creating an account on the New Relic website and navigating to the API keys page. This is where you'll find your API key, which is used to authenticate API requests.
Your API key is a unique identifier that grants access to your New Relic data, so keep it secure and don't share it with anyone. The API key is a 40-character string that begins with "INSERT_KEY_HERE".
To configure the API, you'll need to specify the API endpoint, which is the URL that your API requests will be sent to. The default API endpoint is https://api.newrelic.com/v2.
API Configuration
To configure the New Relic API, you'll need to obtain an API key and account ID from your New Relic account.
You can find your personal API key/user API key in your New Relic API Key. Additionally, you'll need to obtain your account ID from New Relic, which can be found in the Account ID section.
To configure Dapr tracing, you'll need to enable the integration to send data to New Relic's Telemetry Data Platform. This requires a New Relic Insights Insert API key, which can be obtained from your New Relic account.
Here are the specific fields you'll need to fill in when configuring the data source in Grafana:
To get a New Relic license key, sign up for a New Relic account and navigate to the API keys page. The INGEST – LICENSE key is the one you'll need to copy.
Tracing and Monitoring
Tracing and monitoring are crucial components of application performance management. Dapr natively captures metrics and traces that can be sent directly to New Relic.
To export these traces, you need to configure Dapr to send them to New Relic's Trace API using the Zipkin trace format. This requires a New Relic Insights Insert API key.
The traces service in New Relic allows you to query and view the traces stored in New Relic. You can search for traces individually or through a list. The fields available for searching include Trace ID and Query, which can be used to filter traces by specific criteria.
Here are some key fields to know when searching for traces in New Relic:
Viewing Traces
Viewing Traces is a crucial part of the tracing and monitoring process, and New Relic makes it surprisingly easy.
You can view individual traces by searching for them using the Trace ID, which is a unique identifier for each trace. For example, you can use the Trace ID 951ae3313c093aa3278cbc27c0714c94 to view a specific trace.
New Relic also allows you to view a list of traces by using a query with NRQL filter. This can be useful for finding specific traces based on criteria such as duration or application name.
To search for traces, you can use the Query field, which accepts NRQL filter queries. For example, you can use the query "parentId IS NULL AND duration > 0.05 AND appName = 'petclinic'" to find traces that match these conditions.
New Relic provides a detailed overview of Distributed Tracing, which can be accessed through the New Relic Distributed Tracing overview page. This page provides a high-level view of your distributed tracing setup.
To view the details of a specific trace, you can click on the Trace ID from the list of traces. This will take you to the New Relic Distributed Tracing details page, where you can view the full details of the trace.
Here is a table summarizing the fields you can use to search for traces:
You can find more information about the New Relic tracing API at the New Relic documentation site.
Grafana Integration
Grafana Integration is a powerful tool for monitoring and tracing your applications. It's a game-changer for anyone who's ever struggled to make sense of their system's performance.
To get started with Grafana, you'll need to configure a data source. This involves filling in some key fields, including Name, Personal API Key/User API Key, Account ID, Region, and more.
Here are the specific fields you'll need to fill in:
Once you've configured your data source, you can easily tap into the reliability, scale, and security provided by New Relic. This is thanks to the native endpoint for Prometheus metrics into Grafana, making it a seamless integration.
Frequently Asked Questions
What is the New Relic API?
The New Relic API is a powerful tool that allows you to interact with New Relic tools and features programmatically. It enables data retrieval, configuration, and more through a simple REST interface.
How to generate a New Relic API key?
To generate a New Relic API key, navigate to one.newrelic.com/api-keys (or one.eu.newrelic.com/api-keys for EU data center) and click Create a key in the top-right corner. Fill in the required details and click Save to create your new API key.
Sources
- https://prismatic.io/docs/components/new-relic/
- https://kinsta.com/docs/wordpress-hosting/wordpress-monitoring/custom-new-relic-tracking/
- https://docs.dapr.io/operations/observability/tracing/newrelic/
- https://grafana.com/docs/plugins/grafana-newrelic-datasource/latest/
- https://github.com/opsmatters/newrelic-api
Featured Images: pexels.com