Type to search.

Set up gRPC instrumentation

Serverless Observability

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Stack

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

APM Agent .NET

The Elastic APM .NET agent enables you to trace the execution of operations in your .NET applications, sending performance metrics and errors to the Elastic APM server.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

Supported versions

Package Supported versions
Grpc.Net.Client ≥2.23.2 <3.0.0

gRPC server-side instrumentation is built in to ASP.NET Core (≥8.0.0 ≤10.0.x) and does not require an additional package.

For the full compatibility matrix including supported installation methods, refer to RPC frameworks.

Quick start

This page assumes the core agent is already set up. If not, see Set up the APM .NET Agent first.

Server-side gRPC instrumentation is automatically included when using the ASP.NET Core setup. No additional package is required.

Add the Elastic.Apm.GrpcClient NuGet package to your project:

Shell 
dotnet add package Elastic.Apm.GrpcClient

Pass GrpcClientDiagnosticListener to the AddElasticApm method in case of ASP.NET Core:

C# 
using Elastic.Apm.GrpcClient;

app.Services.AddElasticApm(new GrpcClientDiagnosticListener());

or passing GrpcClientDiagnosticSubscriber to the Subscribe method

C# 
using Elastic.Apm;
using Elastic.Apm.GrpcClient;

Agent.Subscribe(new GrpcClientDiagnosticSubscriber());

Diagnostic events from Grpc.Net.Client are captured as spans.