Monitoraggio del servizio " Azure Functions "

È possibile disattivare il sensore " Azure Functions " e filtrarlo in base ai tag e ai gruppi di risorse. È possibile configurare il sensore Azure Functions utilizzando la configurazione dell'agente in <agentinstall_dir>/etc/instana/configuration.yaml :

com.instana.plugin.azure.functionapp:
  # Valid values: true, false
  enabled: false # enabled (true) by default
  # Comma separated list of tags in key:value format
  include_tags:
  # Comma separated list of tags in key:value format
  exclude_tags:
  # Comma separated list of resource groups
  include_resource_groups:
  # Comma separated list of resource groups
  exclude_resource_groups:

Per disabilitare il monitoraggio dei servizi Azure Functions, utilizzare la seguente configurazione:

com.instana.plugin.azure.functionapp:
  enabled: false

È possibile definire più tag e gruppi di risorse, separati da una virgola. I tag devono essere forniti come coppia chiave-valore, separati da due punti (:). Per semplificare la configurazione, è possibile definire quali tag e gruppi di risorse si desidera includere nella scoperta o escludere dalla scoperta. Quando si definisce un tag o un gruppo di risorse in entrambi gli elenchi (includere ed escludere), l'elenco di esclusione ha una priorità maggiore. Se il filtraggio dei servizi non è necessario, non è necessario definire la configurazione. Non è obbligatorio definire tutti i valori per abilitare il filtro.

Per includere i servizi per tag nel rilevamento, utilizzare la seguente configurazione:

com.instana.plugin.azure.functionapp:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Per escludere i servizi per tag dal rilevamento, utilizzare la seguente configurazione:

com.instana.plugin.azure.functionapp:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Per includere i servizi per gruppi di risorse nel rilevamento, utilizzare la seguente configurazione:

com.instana.plugin.azure.functionapp:
  include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)

Per escludere i servizi dal rilevamento dei gruppi di risorse, utilizzare la seguente configurazione:

com.instana.plugin.azure.functionapp:
  exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)

Il filtro di rilevamento può essere configurato a livello globale per tutti i servizi Azure . Quando si definiscono dei filtri per un servizio di " Azure Functions ", i filtri globali vengono sovrascritti. Per ulteriori informazioni sul filtraggio globale del servizio Azure, vedere Azure.

Azure Functions si basa su App Service. La procedura di installazione e configurazione per Azure Functions e Azure App Services è la stessa.

Per installare i tracciatori Instana Azure Functions su Windows, procedere come segue:

1. Accedere al portale Microsoft Azure.

2. Individuare la funzione Azure che si desidera strumentare.

3. Fai clic su "Estensioni" nel pannello "Strumenti di sviluppo".

   

4. Nella pagina "Estensioni", aggiungi l 'estensione " Instana Tracing AppService ". Una volta installata l'estensione "Tracing AppService " di Instana, configurala per poterla utilizzare.

5. Go alla pagina "Estensioni", quindi fare clic su " URL " sull'estensione " Instana Tracing AppService ". Viene visualizzata la finestra di dialogo "Tracciamento per App Services" in " Instana ".

   

   1. Nella finestra " Instana : Tracing for AppServices ", impostare "Enable Tracing" su "On".

   2. Facoltativo: impostare Abilita 64 bit su on.

   3. Nel campo " Chiave agente ", inserisci la chiave di licenza del tuo agente host di Instana.

   4. Nel campo " URL " dell'endpoint, eseguire una delle seguenti operazioni:

      • SaaS: Inserisci l 'endpoint URL per il monitoraggio serverless.
      • Autogestito: Inserire l'endpoint nel formato https://<IP address of the Instana backend>/serverless e impostare il parametro INSTANA_DISABLE_CA_CHECK su true o 1.

   5. Nel campo Livello log , immettere uno dei seguenti livelli di log che si desidera utilizzare:

      • NESSUNA
      • DEBUG
      • INFO
      • WARN
      • ERRORE

      Le informazioni di log vengono generate nella cartella root dell'applicazione Funzione Azure .

   6. Fare clic su Aggiorna configurazione. Le informazioni vengono memorizzate per la funzione Azure .

6. Riavviare la funzione Azure facendo clic su Riavvia. Quando si esegue la funzione ` Azure `, un rewriter ` Instana ` viene associato all'applicazione e ` Instana ` inizia a raccogliere le tracce.

Per visualizzare le tracce nell'interfaccia utente di Instana, apri la dashboard dell'entità " Azure Function" e fai clic su "Upstream/Downstream". Quindi, si possono vedere le tracce raccolte per questa entità. Per ulteriori informazioni sulla visualizzazione delle tracce, consultare la sezione "Analisi delle tracce e delle chiamate ".

Per far funzionare " Instana " nella tua applicazione " Azure Function", aggiungi le seguenti righe al tuo Dockerfile:

DOTNET_STARTUP_HOOKS="[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.dll" \
CORECLR_ENABLE_PROFILING=1 \
CORECLR_PROFILER="{cf0d821e-299b-5307-a3d8-b283c03916dd}" \
CORECLR_PROFILER_PATH="[AzureWebJobsScriptRoot]/bin/instana_tracing/CoreProfiler.so" \
INSTANA_ENDPOINT_URL="[Serverless-ingress-URL-for-your-region]" \
INSTANA_AGENT_KEY="[Your-Instana-agent-key]"

Il valore di INSTANA_ENDPOINT_URL dipende dalla regione. Per ulteriori informazioni, consulta la documentazione relativa agli endpoint per il monitoraggio serverless.

Per ulteriori informazioni sulla configurazione di " Instana " in ".NET Core ", consultare la documentazione di ".NET Core ".

Quando si distribuisce un'applicazione con la funzione " Azure " su Azure utilizzando Docker Container l'opzione, non è necessario installare e utilizzare i pacchetti NuGet di Instana. È invece necessario copiare tutti i pacchetti NuGet di Instana nella cartella "release" in cui è distribuita l'applicazione su Azure.

Per ulteriori informazioni sui nostri pacchetti, consultare la documentazione relativa al tracciamento di .NET.

Assicurati di utilizzare la versione più recente scaricando i pacchetti più recenti da Instana.Tracing.Core, Instana.Tracing.Core.Sdk e Instana.Tracing.Core.Rewriter.Linux.

Una volta terminato il processo di scaricamento, copiare i seguenti file in alcune cartelle dell'applicazione della funzione Azure , facilmente accessibile da Dockerfile:

• Instana.Tracing.Core.dll
• Instana.Tracing.Core.Common.dll
• Instana.Tracing.Core.Instrumentation.dll
• Instana.Tracing.Core.Transport.dll
• Instana.Tracing.Api.dll
• CoreProfiler.so
• instrumentation.json

Quindi, copiare questi file nella cartella delle release in Azure nel modo seguente:

COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Common.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Common.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Instrumentation.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Instrumentation.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Core.Transport.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Core.Transport.dll"
COPY "/[path-to-your-patch-folder]/Instana.Tracing.Api.dll" "[AzureWebJobsScriptRoot]/bin/Instana.Tracing.Api.dll"
COPY "/[path-to-your-patch-folder]/CoreProfiler.so" "[AzureWebJobsScriptRoot]/bin/instana_tracing/CoreProfiler.so"
COPY "/[path-to-your-patch-folder]/instrumentation.json" "[AzureWebJobsScriptRoot]/bin/instana_tracing/instrumentation.json "

Quindi, cancellate i pacchetti Instana.Tracing.Core e seguite le istruzioni già descritte in questo argomento per copiare i file di libreria nella cartella release all'interno del vostro Dockerfile.

Dettagli servizio FunctionApp	Descrizione
ID	L'ID univoco per l'app funzione.
Nome	Il nome dell'istanza FunctionApp .
Immettere	Il tipo FunctionApp .
Ubicazione	La regione in cui si trova l'istanza.
Tipo	Indica il tipo di account FunctionApp .
Sottoscrizione	L'ID sottoscrizione dell'istanza del servizio FunctionApp .
Gruppo di risorse	Il gruppo di risorse dell'istanza del servizio FunctionApp .
Stato	Stato di installazione corrente dell'istanza.

Dettagli servizio funzioni	Descrizione
ID	L'ID univoco per la funzione.
Nome	Il nome dell'istanza del servizio Functions.
Immettere	Funzioni Tipo di servizio.
Ubicazione	La regione in cui si trova l'istanza.
Sottoscrizione	L'ID sottoscrizione dell'istanza del servizio Functions.
Gruppo di risorse	Il gruppo di risorse dell'istanza del servizio Functions.