Strumentazione delle richieste HTTP in ingresso con l'SDK X-Ray per .NET

Puoi usare l'SDK X-Ray per tracciare le richieste HTTP in ingresso elaborate su un'istanza EC2 in Amazon EC2,AWS Elastic Beanstalko Amazon ECS.

Utilizza un gestore di messaggi per analizzare le richieste HTTP in ingresso. Quando aggiungi il gestore di messaggi X-Ray alla tua applicazione, l'SDK X-Ray per .NET crea un segmento per ogni richiesta campionata. Questo segmento include durata, metodo e conclusione della richiesta HTTP. Analisi ulteriori creano sottosegmenti associati a questo segmento.

Ogni segmento ha un nome che identifica l'applicazione nella mappa del servizio. Il segmento può essere denominato staticamente oppure è possibile configurare l'SDK per nominarlo dinamicamente in base all'intestazione host nella richiesta in entrata. La denominazione dinamica consente di raggruppare le tracce in base al nome di dominio nella richiesta e di applicare un nome predefinito se il nome non corrisponde a uno schema previsto (ad esempio, se l'intestazione host è falsificata).

Il gestore dei messaggi crea un segmento per ogni richiesta in entrata con un blocco http che contiene le informazioni riportate qui di seguito:

Analisi delle richieste in entrata (.NET)

Per analizzare le richieste elaborate dalla tua applicazione, chiama RegisterXRay nel metodo Init del tuo file global.asax.

using System.Web.Http;
using Amazon.XRay.Recorder.Handlers.AspNet;

namespace SampleEBWebApplication
{
  public class MvcApplication : System.Web.HttpApplication
  {
    public override void Init()
    {
      base.Init();
      AWSXRayASPNET.RegisterXRay(this, "MyApp");
    }
  }
}

Analisi delle richieste in entrata (.NET Core)

Per analizzare le richieste elaborate dalla tua applicazione, chiamaUseXRaymetodo prima di qualsiasi altro middleware nelConfiguremetodo della classe Startup come idealmente middleware X-Ray dovrebbe essere il primo middleware ad elaborare la richiesta e l'ultimo middleware per elaborare la risposta nella pipeline.

using Microsoft.AspNetCore.Builder;

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
  {
    app.UseXRay("MyApp");
    // additional middleware
    ...
  }

using Microsoft.AspNetCore.Builder;

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
  {
    app.UseExceptionHandler("/Error");
    app.UseXRay("MyApp");
    // additional middleware
    ...
  }

Il metodo UseXRay può anche ricevere un oggetto di configurazione come secondo argomento.

app.UseXRay("MyApp", configuration);

Configurazione di una strategia di denominazione dei segmenti

AWS X-Rayusa unnome servizioper identificare l'applicazione e distinguerla dalle altre applicazioni, database, API esterne eAWSrisorse utilizzate dalla tua applicazione. Quando X-Ray SDK genera segmenti per le richieste in arrivo, registra il nome del servizio dell'applicazione nel segmentocampo name.

L'SDK X-Ray può denominare i segmenti dopo il nome host nell'intestazione della richiesta HTTP. Tuttavia, questa intestazione può essere falsificata, il che potrebbe causare nodi imprevisti nella mappa del servizio. Per impedire all'SDK di assegnare nomi ai segmenti in modo errato a causa di richieste con intestazioni host falsificate, è necessario specificare un nome predefinito per le richieste in arrivo.

Se l'applicazione soddisfa le richieste per più domini, è possibile configurare l'SDK in modo che utilizzi una strategia di denominazione dinamica per rifletterlo nei nomi dei segmenti. Una strategia di denominazione dinamica consente all'SDK di utilizzare il nome host per le richieste che corrispondono a un modello previsto e di applicare il nome predefinito alle richieste che non lo fanno.

Ad esempio, è possibile avere una singola applicazione che elavora le richieste su tre sottodomini:www.example.com,api.example.com, estatic.example.com. È possibile utilizzare una strategia di denominazione dinamica con il modello*.example.comper identificare i segmenti per ogni sottodominio con un nome diverso, risultando in tre nodi di servizio sulla mappa del servizio. Se l'applicazione riceve richieste con un nome host che non corrisponde al modello, verrà visualizzato un quarto nodo sulla mappa del servizio con un nome di fallback specificato.

Per utilizzare lo stesso nome per tutti i segmenti della richiesta, specifica il nome della tua applicazione quando inizializzi il gestore dei messaggi, come illustrato nella sezione precedente. Ciò ha lo stesso effetto di creare una FixedSegmentNamingStrategy e passarla al metodo RegisterXRay.

AWSXRayASPNET.RegisterXRay(this, new FixedSegmentNamingStrategy("MyApp"));

Una strategia di denominazione dinamica definisce un modello al quale devono corrispondere i nomi degli host e un nome di default per l'utilizzo qualora il nome dell'host nella richiesta HTTP non corrisponda al modello. Per denominare i segmenti in modo dinamico, è necessario creare una DynamicSegmentNamingStrategy e passarla al metodo RegisterXRay.

AWSXRayASPNET.RegisterXRay(this, new DynamicSegmentNamingStrategy("MyApp", "*.example.com"));