Service de surveillance d' Azure Functions

Le capteur « Azure Functions » peut être désactivé et filtré par balises et groupes de ressources. Vous pouvez configurer le capteur « Azure Functions » à l'aide de la configuration de l'agent en <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:

Pour désactiver la surveillance des services Azure Functions, utilisez la configuration suivante :

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

Plusieurs balises et groupes de ressources peuvent être définis, séparés par une virgule. Les balises doivent être fournies sous la forme d'une paire clé-valeur, séparée par deux points (:). Pour faciliter la configuration, vous pouvez définir les balises et les groupes de ressources que vous souhaitez inclure dans la découverte ou exclure de la découverte. Lorsque vous définissez une balise ou un groupe de ressources dans les deux listes (inclusion et exclusion), la liste d'exclusion a une priorité plus élevée. Si le filtrage des services n'est pas nécessaire, il n'est pas nécessaire de définir la configuration. Il n'est pas obligatoire de définir toutes les valeurs pour activer le filtrage.

Pour inclure des services par balises dans la reconnaissance, utilisez la configuration suivante:

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

Pour exclure des services par balises de la reconnaissance, utilisez la configuration suivante:

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

Pour inclure des services par groupes de ressources dans la reconnaissance, utilisez la configuration suivante:

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

Pour exclure des services par reconnaissance de groupes de ressources, utilisez la configuration suivante:

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

Le filtrage de reconnaissance peut être configuré globalement pour tous les services Azure. Lorsque vous définissez des filtres pour le service « Azure Functions », les filtres globaux sont remplacés. Pour plus d'informations sur le filtrage global de la découverte des services, voir Azure configuration.

Azure Functions est tiré de App Service. La procédure d'installation et de configuration est identique pour Azure Functions et Azure App Services.

Pour installer les traceurs Instana Azure Functions sur Windows, procédez comme suit :

1. Connectez-vous au portailMicrosoft Azure.

2. Localisez la fonction Azure que vous souhaitez instrumenter.

3. Cliquez sur « Extensions » dans le panneau « Outils de développement ».

   

4. Sur la page Extensions, ajoutez l 'extension « Instana Tracing AppService ». Une fois l'extension « Tracing AppService » d' Instana installée, configurez-la pour pouvoir l'utiliser.

5. Go Accédez à la page « Extensions », puis cliquez sur « URL » (Gérer) pour l'extension « Instana Tracing AppService ». La boîte de dialogue « Tracing for App Services » (Suivi des services d'application) de l' Instana s s'affiche.

   

   1. Dans la fenêtre « Tracing » (Suivi) de l' Instana, sous « AppServices » (Suivi de l'), activez l'option « Enable Tracing » (Activer le suivi).

   2. Facultatif: définissez Enable 64 bit sur on.

   3. Dans le champ « Clé de l'agent », saisissez la clé de licence de votre agent hôte d' Instana.

   4. Dans le champ « URL s du terminal », procédez de l'une des manières suivantes :

      • SaaS: Saisissez l'adresse de l'endpoint URL pour la surveillance sans serveur.
      • Auto-hébergé : Entrez le point de terminaison dans le format https://<IP address of the Instana backend>/serverless et définissez le paramètre INSTANA_DISABLE_CA_CHECK sur true ou 1.

   5. Dans la zone Niveau de journalisation , entrez l'un des niveaux de journalisation suivants que vous souhaitez utiliser:

      • AUCUN
      • DÉBOGAGE
      • INFOS
      • WARN
      • ERROR

      Les informations de journal sont générées dans le dossier racine de l'application Azure Function.

   6. Cliquez sur Mettre à jour la configuration. Les informations sont sauvegardées pour la fonction Azure .

6. Redémarrez la fonction Azure en cliquant sur Redémarrer. Lorsque vous exécutez votre fonction Azure, un module de réécriture Instana est associé à l'application, et Instana commence à collecter les traces.

Pour consulter les traces dans l'interface utilisateur d' Instana, ouvrez le tableau de bord de votre entité « Azure Function » et cliquez sur « Upstream/Downstream ». Ensuite, vous pouvez voir les traces qui sont collectées pour cette entité. Pour plus d'informations sur la consultation des traces, consultez la section « Analyse des traces et des appels ».

Pour que l' Instana e fonctionne dans votre application de fonctions Azure, ajoutez les lignes suivantes à votre 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]"

La valeur INSTANA_ENDPOINT_URL dépend de votre région. Pour plus d'informations, consultez la documentation sur les points de terminaison pour la surveillance sans serveur.

Pour plus d'informations sur la configuration d' Instana dans .NET Core, consultez la documentation d'.NET Core.

Lorsque l'application de la fonction « Azure » est déployée sur Azure à l'aide de Docker Container l'option, il n'est pas nécessaire d'installer ni d'utiliser les paquets NuGet Instana. Vous devez plutôt copier tous les paquets NuGet de Instana dans le dossier « release » où l'application est déployée sur Azure.

Pour plus d'informations sur nos packages, consultez la documentation sur le traçage d'.NET.

Assurez-vous d'utiliser la dernière version en téléchargeant les derniers paquets Instana.Tracing.Core, Instana.Tracing.Core.Sdk et Instana.Tracing.Core.Rewriter.Linux.

Une fois le processus de téléchargement terminé, copiez les fichiers suivants dans certains dossiers de votre application Azure Function Application, qui est facilement accessible à partir de 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

Copiez ensuite ces fichiers dans le dossier d'édition sur Azure comme suit:

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 "

Ensuite, supprimez les paquets Instana.Tracing.Core et suivez les instructions déjà décrites dans cette rubrique pour copier les fichiers de la bibliothèque dans le dossier release à l'intérieur de votre Dockerfile.