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.

Nota

PerAWS LambdaFunzioni, Lambda crea un segmento per ogni richiesta campionata. Per ulteriori informazioni, consultare AWS Lambda e AWS X-Ray.

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).

Richieste inoltrate

Se un sistema di bilanciamento del carico o un altro intermediario inoltra una richiesta all'applicazione, X-Ray preleva l'IP del client dalX-Forwarded-Forintestazione nella richiesta anziché dall'IP di origine nel pacchetto IP. L'IP client registrato per una richiesta inoltrata può essere falsificato, quindi non dovrebbe essere attendibile.

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

• HTTP method (Metodo HTTP)— GET, POST, PUT, DELETE, ecc.

• Indirizzo client— Indirizzo IP del client che ha inviato la richiesta.

• Codice di risposta— Codice HTTP di risposta per la richiesta completata.

• Timing (Tempo)— Ora di inizio (quando è stata ricevuta la richiesta) e di fine (quando è stata inviata la risposta).

• User Agent— Iluser-agentdalla richiesta.

• Lunghezza del contenuto— Ilcontent-lengthdella risposta.

Analisi delle richieste in entrata (.NET)

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

Esempio global.asax - Gestore messaggi

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.

Nota

Per .NET Core 2.0, se hai unUseExceptionHandlermetodo nell'applicazione, assicurarsi di chiamareUseXRaydopoUseExceptionHandlermetodo per garantire la registrazione delle eccezioni.

Esempio Startup.cs

.NET Core 2.1 and above

using Microsoft.AspNetCore.Builder;

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

.NET Core 2.0

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"));

Nota

È possibile sovrascrivere il nome di servizio predefinito definito nel codice con ilAWS_XRAY_TRACING_NAME Variabile di ambiente.

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"));