SDK per la tracciabilità completa del framework basato sulla configurazione (.NET )

L'SDK basato sulla configurazione è fragile rispetto alle modifiche nella tua applicazione. È possibile ridenominare una classe o un metodo e improvvisamente la configurazione non corrisponde più e si perdono i dati di traccia. Quando possibile, consigliamo di utilizzare l 'SDK completo del framework .NET, che è molto più resistente alle modifiche del codice e offre più funzionalità per aiutarti a raggiungere i tuoi obiettivi.

La configurazione è specificata nel configuration.yaml file.

Il seguente elenco descrive il formato generale della configurazione:

# .NET Full Framework Tracing
com.instana.plugin.clr:
  instrumentation:
    sdk:
      targets:
        - match:
            type: class
            class: '<type-name>'
            method: '<method-name>'
            arguments: <number of arguments>
          span:
            name: '<span-name>'
            type: 'ENTRY' | 'EXIT' | 'INTERMEDIATE'
            tags:
              - name: '<name of tag>'
                kind: argument
                index: <0-based index of the method's argument>
              - name: '<name of tag>'
                kind: constant
                value: '<constant value>'
              - name: '<name of tag>'
                kind: return
 

È possibile definire più destinazioni all'interno della chiave targets , ognuna delle quali specifica un'estensione da creare. L'oggetto match di uno target specifica il metodo a cui applicare la strumentazione. L'oggetto span specifica come creare lo span, compreso il suo nome (utilizzato, ad esempio, in Unbounded Analytics per il call.name filtro) e quali tag devono essere impostati.

Se un Exception viene propagato al di fuori di un metodo strumentato, lo span verrà automaticamente contrassegnato come errato e il valore di Exception::Message verrà impostato come messaggio di errore, che potrai cercare in Unbounded Analytics tramite il call.error.message tag.

Il seguente frammento mostra una configurazione di esempio della modalità di traccia di un'applicazione che gestisce i lavori batch:

com.instana.plugin.clr:
  instrumentation:
    sdk:
      targets:
        - match:
            type: class
            class: Example.BatchJobStarter
            method: ExecuteJob
            arguments: 1
          span:
            name: BatchJob
            type: ENTRY
            tags:
              - name: endpoint
                kind: constant
                value: BatchJob
              - name: batch.job
                kind: argument
                index: 0
        - match:
            type: class
            class: Example.ProprietaryDatabaseClient
            method: ExecuteQuery
            arguments: 1
          span:
            name: DatabaseCall
            type: EXIT
            tags:
              - name: db.connection_string
                kind: constant
                value: 'Data Source=SomeServer;Initial Catalog=SomeDB'
              - name: db.statement
                kind: argument
                index: 0
 

Per prima cosa, il metodo ExecuteJob nella classe Example.BatchJobStarter viene strumentato per creare le voci con nome BatchJob, l'annotazione endpoint con il valore costante BatchJobe l'annotazione batch.job con il primo argomento come valore.

Inoltre, le chiamate DB in uscita durante l'elaborazione batch, ovvero i richiami del metodo ExecuteQuery in Example.ProprietaryDatabaseClient, creeranno le estrazioni di uscita con nome DatabaseCall e l'annotazione db.connection_string con il valore costante Data Source=SomeServer;Initial Catalog=SomeDB e l'annotazione db.statement con il primo argomento del richiamo del metodo.

L'elaborazione di un nuovo batch con ExecuteJob avvierà una nuova traccia e i successivi aggiornamenti DB con ExecuteQuery verranno elencati come elementi secondari al suo interno. Tutte le funzionalità di Instana, come Unbounded Analytics, possono essere utilizzate esattamente come le tracce create con Instana AutoTrace.

Le seguenti restrizioni si applicano all'SDK Full Framework Trace di .NET basato sulla configurazione:

• La strumentazione dei costruttori non è supportata.
• L'implementazione di metodi statici non è supportata.
• L'avvio di un'estensione in un metodo e la sua chiusura in un altro metodo non è supportato; ossia, l'SDK basato sulla configurazione non ha un equivalente per MethodPairInstrumentation utilizzato in autotrace
• La cattura di tutti gli argomenti o del valore di ritorno senza la creazione esplicita di un tag non è supportata.
• La specifica di modelli di nomi per classi o metodi non è supportata.
• Il ripristino di un contesto di traccia prima della creazione di un'estensione non è supportato