• /
  • ログイン
  • 無料アカウント

View your OpenTelemetry data in New Relic

After you import OpenTelemetry data into New Relic, you can use a variety of tools to analyze it. Take a look at these UI options:

Explorer: Get the big picture along with the details

The New Relic Explorer tab is a good place to start gathering information about your services. It offers you a way to filter services and then filter the data to show a variety of views into your data.

Find your service (entity)

To get started in Explorer, you need to find your service:

  1. Go to one.newrelic.com.

  2. In the left sidebar, click Services - OpenTelemetry:

    Screen capture showing how to filter for OpenTelemetry services.

  3. In the center pane, click the service you want to know more about, or find your service by entering the name in the top filter bar.

Narrow down your data with filters

Once you have your entity, you can then filter for data from your service.

With the filter bar Narrow data to..., you can highlight a specific facet of the telemetry recorded for your service. For example, you may want to see the error rate for a particular version of the service that you've deployed in a canary instance, so you add a filter for service.version='1.2.3'.

Filters are preserved when navigating between different views of your data for a service. For example, the filter for service.version='1.2.3' carries over to the Transactions view, so that you would see telemetry on requests to the endpoints (transactions) that are running version 1.2.3 of your service, and not any other versions.

Filters are preserved when navigating between the Summary, Transactions, Databases, Externals, Errors, and JVMs views.

Filters are also preserved when navigating to the Distributed tracing view, but with limitations. Only filter conditions that use the equals operator ("=") are currently supported when navigating to Distributed tracing. If you navigate back from the Distributed tracing page, the filters you selected on the previous view will come back.

Once you filter your data, the UI has various views in the left-navigation pane. See our descriptions below for view details.

Summary page

After you click on a service in the Explorer tab, you see the Summary page listing various golden signals about your entity. Golden signals are key monitoring details such as response time, throughput, and error rate. By using this information, you can quickly decide if you need to dig deeper.

For your data to appear in this section, make sure it has the following:

UI area

Attribute

Response time

span.kind = server or consumer

Throughput

span.kind = server or consumer

Error rate

  • span.kind = server or consumer
  • otel.status_code = ERROR

Service instances pane

service.instance.id (usually set via the OTel resource API)

Distributed tracing

In Distributed tracing, you can locate traces and examine span details. For your trace data to appear in the New Relic UI, it needs to conform to the OpenTelemetry trace semantic conventions. Also, in the Traces section of our best practices guide, you can find some tips about making sure your traces and spans appear in New Relic.

The following attributes are typically not added explicitly to spans. Rather, they are usually set when creating a span or performing operations (for example, recording an error) on a span using the OpenTelemetry SDK.

Attribute

Description

name

A span’s name is generally set when starting a span. The name can generally be anything, but the OpenTelemetry specification provides guidance for certain types of spans like Database spans or HTTP spans.

span.kind

A span’s kind is generally set when starting a span. New Relic uses span.kind to infer that a span is an entry point to a given service. When span.kind = server or consumer it is considered an entry point. When span.kind = client or producer, it is considered a call to an external service or database system.

otel.status_code

  • A span’s status is set using the span API. The otel.status_code attribute is how it is manifested by New Relic.
  • The UI primarily uses otel.status_code for the purpose of identifying errors.

Find traces and their associated spans

Here are some ways to target your searches:

  1. To find the traces you want, you can run queries like these in the filter bar:
    • service.name = YOUR_SERVICE_NAME
    • trace.id = YOUR_TRACE_ID
  2. When you find an interesting trace, click on it to display a waterfall diagram showing the spans of the trace.
  3. Click on specific spans within the trace to display span details in the right panel.

ヒント

For more ways to filter traces, see our distributed tracing UI page.

View spans with errors

After you click on a span in the trace waterfall view, you can see span errors in the right panel under Error details.

Screenshot showing the right pane with Error details section

The error details are populated by spans containing otel.status_code = ERROR and display the content of otel.status_description.

To narrow your search for spans with errors, you can enter otel.status_code = ERROR directly in the distributed tracing filter bar.

View span events

If you send span events as described by the OpenTelemetry specification, you can view them in the New Relic UI. Span events have two general types:

  • Exceptions
  • Non-exceptions (for example, logs)

If you have span events, links for these appear in the right pane:

  1. Click on a span in the waterfall view.

  2. In the right pane, click View span events, or you can expand Error details and click the link at the bottom of the errors.

    Screenshot showing the right pane showing the two links for span events

  3. When you're in span events and only want to view exceptions, slide the toggle Only show exceptions.

Screenshot showing span events and how you can filter just for exceptions

ヒント

OpenTelemetry exceptions handled by the app/service are displayed independently of span error status and are not necessarily associated with a span error status.

Databases

The Databases page shows an application's database and cache data. The page shows individual database transactions as a sortable table, and shows operations, throughput, and response time as charts.

For your data to appear in this section, make sure it has the following:

UI area

Attribute

Top database calls

  • span.kind = client or producer
  • db.system
  • Facets by span name

Top databases (by query time)

  • span.kind = client or producer
  • db.system
  • Facets by db.system

Top databases (by throughput)

  • span.kind = client or producer
  • db.system
  • Facets by db.system

Errors

On the Errors page, you can see total errors as well as charts showing error count and error rate.

For your data to appear in this section, make sure it has the following:

  • span.kind = server or consumer
  • otel.status_code = ERROR
  • Facets by span name

Externals

Externals capture calls to out-of-process services such as web services, resources in the cloud, and other network entities.

For your data to appear in this section, make sure it has the following:

  • span.kind = client or producer
  • db.system is not present

JVMs

When you drill into a specific JVM, the UI display charts driven by JVM metric data:

For your data to appear in this section, make sure it has the following:

  • Requires a unique service.instance.id attribute for rendering the list of JVMs
  • Service.instance.id is an OpenTelemetry resource attribute

Logs

The Logs page displays logs from your application. For more information about how to associate log data to your application in New Relic, see our OpenTelemetry and logging documentation.

For your data to appear in this section, make sure it has the following:

  • service.name
  • To correlate with trace data, the logs should contain the trace.id and span.id attributes.

Metrics explorer

For selected OpenTelemetry languages, you can see information about your metrics in this section. Also, if you are using the Prometheus exporter with OpenTelemetry, you can view your metric data here.

Screen shot showing the metric explorer

Transactions

Use Transactions to identify slow or error transactions that might be causing a spike in your application's response time. To get a list of transactions: From the Transaction Summary page, select the transactions table.

For your data to appear in this section, make sure it has the following:

UI area

Description

Top Transactions

  • span.kind = server or consumer
  • Facets by span name

Throughput

  • span.kind = server or consumer
  • Facets by span name

Data explorer and query builder

Explore your metrics and traces using the data explorer, or write your own queries in query builder using NRQL. For more on how to query your data once it's in New Relic, see Query your data and Introduction to NRQL.

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください:

問題を作成するこのページを編集する
Copyright © 2020 New Relic Inc.