Informations de référence sur le fichier host.json pour Azure Functions 2.x et ultérieurhost.json reference for Azure Functions 2.x and later

Le fichier de métadonnées host.json contient les options de configuration globale qui affectent l’ensemble des fonctions d’une application de fonction.The host.json metadata file contains global configuration options that affect all functions for a function app. Cet article liste les paramètres disponibles à compter de la version 2.x du runtime Azure Functions.This article lists the settings that are available starting with version 2.x of the Azure Functions runtime.

Notes

Cet article concerne Azure Functions versions 2.x et ultérieures.This article is for Azure Functions 2.x and later versions. Pour obtenir une référence de host.json dans Functions 1.x, consultez Informations de référence sur le fichier host.json pour Azure Functions 1.x.For a reference of host.json in Functions 1.x, see host.json reference for Azure Functions 1.x.

Les autres options de configuration d’application de fonction sont managées dans vos paramètres d’application.Other function app configuration options are managed in your app settings.

Certains paramètres host.json sont uniquement utilisés lors de l’exécution locale dans le fichier local.settings.json.Some host.json settings are only used when running locally in the local.settings.json file.

Exemple de fichier host.jsonSample host.json file

L’exemple de fichier host.json suivant contient toutes les options possibles spécifiées (sauf celles qui sont destinées à un usage interne uniquement).The following sample host.json file has all possible options specified (excluding any that are for internal use only).

{
    "version": "2.0",
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    },
    "extensions": {
        "cosmosDb": {},
        "durableTask": {},
        "eventHubs": {},
        "http": {},
        "queues": {},
        "sendGrid": {},
        "serviceBus": {}
    },
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    },
    "functions": [ "QueueProcessor", "GitHubWebHook" ],
    "functionTimeout": "00:05:00",
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    },
    "logging": {
        "fileLoggingMode": "debugOnly",
        "logLevel": {
          "Function.MyFunction": "Information",
          "default": "None"
        },
        "applicationInsights": {
            "samplingSettings": {
              "isEnabled": true,
              "maxTelemetryItemsPerSecond" : 20,
              "evaluationInterval": "01:00:00",
              "initialSamplingPercentage": 1.0, 
              "samplingPercentageIncreaseTimeout" : "00:00:01",
              "samplingPercentageDecreaseTimeout" : "00:00:01",
              "minSamplingPercentage": 0.1,
              "maxSamplingPercentage": 0.1,
              "movingAverageRatio": 1.0
            },
            "samplingExcludedTypes" : "Dependency;Event",
            "samplingIncludedTypes" : "PageView;Trace",
            "enableLiveMetrics": true,
            "enableDependencyTracking": true,
            "enablePerformanceCountersCollection": true,            
            "httpAutoCollectionOptions": {
                "enableHttpTriggerExtendedInfoCollection": true,
                "enableW3CDistributedTracing": true,
                "enableResponseHeaderInjection": true
            },
            "snapshotConfiguration": {
                "agentEndpoint": null,
                "captureSnapshotMemoryWeight": 0.5,
                "failedRequestLimit": 3,
                "handleUntrackedExceptions": true,
                "isEnabled": true,
                "isEnabledInDeveloperMode": false,
                "isEnabledWhenProfiling": true,
                "isExceptionSnappointsEnabled": false,
                "isLowPrioritySnapshotUploader": true,
                "maximumCollectionPlanSize": 50,
                "maximumSnapshotsRequired": 3,
                "problemCounterResetInterval": "24:00:00",
                "provideAnonymousTelemetry": true,
                "reconnectInterval": "00:15:00",
                "shadowCopyFolder": null,
                "shareUploaderProcess": true,
                "snapshotInLowPriorityThread": true,
                "snapshotsPerDayLimit": 30,
                "snapshotsPerTenMinutesLimit": 1,
                "tempFolder": null,
                "thresholdForSnapshotting": 1,
                "uploaderProxy": null
            }
        }
    },
    "managedDependency": {
        "enabled": true
    },
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    },
    "watchDirectories": [ "Shared", "Test" ]
}

Les sections suivantes de cet article expliquent chaque propriété de niveau supérieur.The following sections of this article explain each top-level property. Toutes les autres propriétés sont facultatives sauf indication contraire.All are optional unless otherwise indicated.

aggregatoraggregator

Spécifie le nombre d’appels de fonction agrégés lorsque vous calculez des métriques pour Application Insights.Specifies how many function invocations are aggregated when calculating metrics for Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}
PropriétéProperty DefaultDefault DescriptionDescription
batchSizebatchSize 1 0001000 Nombre maximal de requêtes à agréger.Maximum number of requests to aggregate.
flushTimeoutflushTimeout 00:00:3000:00:30 Période maximale d’agrégation.Maximum time period to aggregate.

Les appels de fonction sont agrégés lorsque la première des deux limites est atteinte.Function invocations are aggregated when the first of the two limits are reached.

applicationInsightsapplicationInsights

Ce paramètre est un enfant de la journalisation.This setting is a child of logging.

Contrôle les options disponibles dans Application Insights, notamment les options d’échantillonnage.Controls options for Application Insights, including sampling options.

Pour obtenir la structure JSON complète, reportez-vous à l’exemple de fichier host.json précédent.For the complete JSON structure, see the earlier example host.json file.

Notes

L’échantillonnage de journal peut faire que certaines exécutions n’apparaissent pas dans le panneau de surveillance Application Insights.Log sampling may cause some executions to not show up in the Application Insights monitor blade. Pour éviter l’échantillonnage des journaux, ajoutez samplingExcludedTypes: "Request" à la valeur applicationInsights.To avoid log sampling, add samplingExcludedTypes: "Request" to the applicationInsights value.

PropriétéProperty DefaultDefault DescriptionDescription
samplingSettingssamplingSettings n/an/a Consultez applicationInsights.samplingSettings.See applicationInsights.samplingSettings.
samplingExcludedTypessamplingExcludedTypes nullnull Une liste délimitée par des points-virgules des types que vous ne souhaitez pas voir échantillonnés.A semi-colon delimited list of types that you don't want to be sampled. Les types reconnus sont : Dependency, Event, Exception, PageView, Request et Trace.Recognized types are: Dependency, Event, Exception, PageView, Request, Trace. Toutes les instances des types spécifiés sont transmises ; les types qui ne sont pas spécifiés sont échantillonnés.All instances of the specified types are transmitted; the types that aren't specified are sampled.
samplingIncludedTypessamplingIncludedTypes nullnull Liste délimitée par des points-virgules des types que vous souhaitez échantillonner ; une liste vide signifie que tous les types sont impliqués.A semi-colon delimited list of types that you want to be sampled; an empty list implies all types. Le type répertorié dans samplingExcludedTypes remplace les types répertoriés ici.Type listed in samplingExcludedTypes override types listed here. Les types reconnus sont : Dependency, Event, Exception, PageView, Request et Trace.Recognized types are: Dependency, Event, Exception, PageView, Request, Trace. Toutes les instances des types spécifiés sont transmises ; les types qui ne sont pas spécifiés sont échantillonnés.All instances of the specified types are transmitted; the types that aren't specified are sampled.
enableLiveMetricsenableLiveMetrics truetrue Active la collecte des métriques temps réel.Enables live metrics collection.
enableDependencyTrackingenableDependencyTracking truetrue Active le suivi des dépendances.Enables dependency tracking.
enablePerformanceCountersCollectionenablePerformanceCountersCollection truetrue Active la collecte des compteurs de performances Kudu.Enables Kudu performance counters collection.
liveMetricsInitializationDelayliveMetricsInitializationDelay 00:00:1500:00:15 À usage interne uniquement.For internal use only.
httpAutoCollectionOptionshttpAutoCollectionOptions n/an/a Consultez applicationInsights.httpAutoCollectionOptions.See applicationInsights.httpAutoCollectionOptions.
snapshotConfigurationsnapshotConfiguration n/an/a Consultez applicationInsights.snapshotConfiguration.See applicationInsights.snapshotConfiguration.

applicationInsights.samplingSettingsapplicationInsights.samplingSettings

PropriétéProperty DefaultDefault DescriptionDescription
isEnabledisEnabled truetrue Active ou désactive l’échantillonnage.Enables or disables sampling.
maxTelemetryItemsPerSecondmaxTelemetryItemsPerSecond 2020 Nombre cible d’éléments de télémétrie enregistrés par seconde sur chaque hôte de serveur.The target number of telemetry items logged per second on each server host. Si votre application s’exécute sur de nombreux ordinateurs hôtes, réduisez cette valeur pour rester dans votre taux de trafic cible global.If your app runs on many hosts, reduce this value to remain within your overall target rate of traffic.
evaluationIntervalevaluationInterval 01:00:0001:00:00 Intervalle auquel le taux actuel de télémétrie est réévalué.The interval at which the current rate of telemetry is reevaluated. L’évaluation est effectuée sous forme de moyenne mobile.Evaluation is performed as a moving average. Vous souhaiterez peut-être raccourcir cet intervalle si vos données de télémétrie sont soumises à des pics soudains.You might want to shorten this interval if your telemetry is liable to sudden bursts.
initialSamplingPercentageinitialSamplingPercentage 1.01.0 Pourcentage d’échantillonnage initial appliqué au début du processus d’échantillonnage pour faire varier dynamiquement le pourcentage.The initial sampling percentage applied at the start of the sampling process to dynamically vary the percentage. Ne diminuez pas la valeur pendant le débogage.Don't reduce value while you're debugging.
samplingPercentageIncreaseTimeoutsamplingPercentageIncreaseTimeout 00:00:0100:00:01 Lorsque la valeur de pourcentage d’échantillonnage change, cette propriété détermine le moment où Application Insights est autorisé à augmenter à nouveau le pourcentage d’échantillonnage pour capturer plus de données.When the sampling percentage value changes, this property determines how soon afterwards Application Insights is allowed to raise sampling percentage again to capture more data.
samplingPercentageDecreaseTimeoutsamplingPercentageDecreaseTimeout 00:00:0100:00:01 Lorsque la valeur de pourcentage d’échantillonnage change, cette propriété détermine le moment où Application Insights est autorisé à diminuer à nouveau le pourcentage d’échantillonnage pour capturer moins de données.When the sampling percentage value changes, this property determines how soon afterwards Application Insights is allowed to lower sampling percentage again to capture less data.
minSamplingPercentageminSamplingPercentage 0.10.1 Comme le pourcentage d’échantillonnage varie, cette propriété détermine le pourcentage d’échantillonnage autorisé minimal.As sampling percentage varies, this property determines the minimum allowed sampling percentage.
minSamplingPercentagemaxSamplingPercentage 0.10.1 Comme le pourcentage d’échantillonnage varie, cette propriété détermine le pourcentage d’échantillonnage autorisé maximal.As sampling percentage varies, this property determines the maximum allowed sampling percentage.
movingAverageRatiomovingAverageRatio 1.01.0 Lors du calcul de la moyenne mobile, poids affecté à la valeur la plus récente.In the calculation of the moving average, the weight assigned to the most recent value. Utilisez une valeur inférieure ou égale à 1.Use a value equal to or less than 1. Plus les valeurs sont petites, moins l’algorithme est réactif en cas de modifications brusques.Smaller values make the algorithm less reactive to sudden changes.

applicationInsights.httpAutoCollectionOptionsapplicationInsights.httpAutoCollectionOptions

PropriétéProperty DefaultDefault DescriptionDescription
enableHttpTriggerExtendedInfoCollectionenableHttpTriggerExtendedInfoCollection truetrue Active ou désactive les informations de requête HTTP étendues pour les déclencheurs HTTP : en-têtes de corrélation de requête entrante, prise en charge des clés d’instrumentation multiples, méthode HTTP, chemin d’accès et réponse.Enables or disables extended HTTP request information for HTTP triggers: incoming request correlation headers, multi-instrumentation keys support, HTTP method, path, and response.
enableW3CDistributedTracingenableW3CDistributedTracing truetrue Active ou désactive la prise en charge du protocole W3C Distributed Tracing Protocol (et active le schéma de corrélation hérité).Enables or disables support of W3C distributed tracing protocol (and turns on legacy correlation schema). Activé par défaut si enableHttpTriggerExtendedInfoCollection a la valeur true.Enabled by default if enableHttpTriggerExtendedInfoCollection is true. Si enableHttpTriggerExtendedInfoCollection a la valeur false, cet indicateur s’applique uniquement aux demandes sortantes, et non aux demandes entrantes.If enableHttpTriggerExtendedInfoCollection is false, this flag applies to outgoing requests only, not incoming requests.
enableResponseHeaderInjectionenableResponseHeaderInjection truetrue Active ou désactive l’injection d’en-têtes de corrélation à composants multiples dans les réponses.Enables or disables injection of multi-component correlation headers into responses. L’activation de l’injection permet à Application Insights de construire un mappage d’application en cas d’utilisation de plusieurs clés d’instrumentation.Enabling injection allows Application Insights to construct an Application Map to when several instrumentation keys are used. Activé par défaut si enableHttpTriggerExtendedInfoCollection a la valeur true.Enabled by default if enableHttpTriggerExtendedInfoCollection is true. Ce paramètre ne s’applique pas si enableHttpTriggerExtendedInfoCollection a la valeur false.This setting doesn't apply if enableHttpTriggerExtendedInfoCollection is false.

applicationInsights.snapshotConfigurationapplicationInsights.snapshotConfiguration

Pour plus d’informations sur les instantanés, consultez Captures instantanées de débogage sur exceptions levées dans des applications .NET et Résoudre les problèmes d’activation du Débogueur de capture instantanée Application Insights ou d’affichage d’instantanés.For more information on snapshots, see Debug snapshots on exceptions in .NET apps and Troubleshoot problems enabling Application Insights Snapshot Debugger or viewing snapshots.

PropriétéProperty DefaultDefault DescriptionDescription
agentEndpointagentEndpoint nullnull Point de terminaison utilisé pour se connecter au service de Débogueur de capture instantanée Application Insights.The endpoint used to connect to the Application Insights Snapshot Debugger service. Si la valeur est null, un point de terminaison par défaut est utilisé.If null, a default endpoint is used.
captureSnapshotMemoryWeightcaptureSnapshotMemoryWeight 0.50.5 Poids donné à la taille actuelle de la mémoire du processus lors de la vérification s’il y a assez de mémoire pour prendre un instantané.The weight given to the current process memory size when checking if there's enough memory to take a snapshot. La valeur attendue est une fraction supérieure à 0 (0 < CaptureSnapshotMemoryWeight < 1).The expected value is a greater than 0 proper fraction (0 < CaptureSnapshotMemoryWeight < 1).
failedRequestLimitfailedRequestLimit 33 Limite du nombre de demandes ayant échoué pour demander des captures instantanées avant que le processeur de télémétrie soit désactivé.The limit on the number of failed requests to request snapshots before the telemetry processor is disabled.
handleUntrackedExceptionshandleUntrackedExceptions truetrue Active ou désactive le suivi des exceptions qui ne sont pas suivies par la télémétrie Application Insights.Enables or disables tracking of exceptions that aren't tracked by Application Insights telemetry.
isEnabledisEnabled truetrue Active ou désactive la collecte de captures instantanéesEnables or disables snapshot collection
isEnabledInDeveloperModeisEnabledInDeveloperMode falsefalse Active ou désactive la collecte de captures instantanées activée en mode développeur.Enables or disables snapshot collection is enabled in developer mode.
isEnabledWhenProfilingisEnabledWhenProfiling truetrue Active ou désactive la création de captures instantanées même si Application Insights Profiler collecte une session de profilage détaillée.Enables or disables snapshot creation even if the Application Insights Profiler is collecting a detailed profiling session.
isExceptionSnappointsEnabledisExceptionSnappointsEnabled falsefalse Active ou désactive le filtrage des exceptions.Enables or disables filtering of exceptions.
isLowPrioritySnapshotUploaderisLowPrioritySnapshotUploader truetrue Détermine s’il faut exécuter le processus SnapshotUploader en dessous de la priorité normale.Determines whether to run the SnapshotUploader process at below normal priority.
maximumCollectionPlanSizemaximumCollectionPlanSize 5050 Nombre maximal de problèmes que nous pouvons suivre à tout moment dans une plage comprise entre 1 et 9999.The maximum number of problems that we can track at any time in a range from one to 9999.
maximumSnapshotsRequiredmaximumSnapshotsRequired 33 Nombre maximal de captures instantanées collectées pour un seul problème dans une plage comprise entre 1 et 999.The maximum number of snapshots collected for a single problem, in a range from one to 999. Un problème peut être assimilé à une instruction throw individuelle dans votre application.A problem may be thought of as an individual throw statement in your application. Une fois que le nombre de captures instantanées collectées pour un problème atteint cette valeur, aucune capture instantanée n’est collectée pour ce problème jusqu’à ce que les compteurs de problèmes soient réinitialisés (voir problemCounterResetInterval) et que la limite de thresholdForSnapshotting soit de nouveau atteinte.Once the number of snapshots collected for a problem reaches this value, no more snapshots will be collected for that problem until problem counters are reset (see problemCounterResetInterval) and the thresholdForSnapshotting limit is reached again.
problemCounterResetIntervalproblemCounterResetInterval 24:00:0024:00:00 Fréquence de réinitialisation des compteurs de problèmes dans une plage comprise entre une minute et sept jours.How often to reset the problem counters in a range from one minute to seven days. Lorsque cet intervalle est atteint, tous les compteurs de problèmes sont remis à zéro.When this interval is reached, all problem counts are reset to zero. Les problèmes existants qui ont déjà atteint le seuil pour les captures instantanées, mais qui n’ont pas encore généré le nombre de captures instantanées dans maximumSnapshotsRequired, subsistent.Existing problems that have already reached the threshold for doing snapshots, but haven't yet generated the number of snapshots in maximumSnapshotsRequired, remain active.
provideAnonymousTelemetryprovideAnonymousTelemetry truetrue Détermine s’il faut envoyer une télémétrie d’utilisation et d’erreur anonymes à Microsoft.Determines whether to send anonymous usage and error telemetry to Microsoft. Cette télémétrie peut être utilisée si vous contactez Microsoft pour vous aider à résoudre les problèmes liés au Débogueur de capture instantanée.This telemetry may be used if you contact Microsoft to help troubleshoot problems with the Snapshot Debugger. Elle permet également d’analyser les modèles d’utilisation.It is also used to monitor usage patterns.
reconnectIntervalreconnectInterval 00:15:0000:15:00 Fréquence de reconnexion au point de terminaison Débogueur de capture instantanée.How often we reconnect to the Snapshot Debugger endpoint. La plage autorisée est comprise entre une minute et un jour.Allowable range is one minute to one day.
shadowCopyFoldershadowCopyFolder nullnull Spécifie le dossier à utiliser pour les fichiers binaires de clichés instantanés.Specifies the folder to use for shadow copying binaries. Si la valeur n’est pas définie, les dossiers spécifiés par les variables d’environnement suivantes sont essayées dans l’ordre : Fabric_Folder_App_Temp, LOCALAPPDATA, APPDATA, TEMP.If not set, the folders specified by the following environment variables are tried in order: Fabric_Folder_App_Temp, LOCALAPPDATA, APPDATA, TEMP.
shareUploaderProcessshareUploaderProcess truetrue Si la valeur est true, une seule instance de SnapshotUploader collecte et charge des captures instantanées pour plusieurs applications qui partagent la clé InstrumentationKey.If true, only one instance of SnapshotUploader will collect and upload snapshots for multiple apps that share the InstrumentationKey. Si la valeur est false, SnapshotUploader est unique pour chaque tuple (ProcessName, InstrumentationKey).If set to false, the SnapshotUploader will be unique for each (ProcessName, InstrumentationKey) tuple.
snapshotInLowPriorityThreadsnapshotInLowPriorityThread truetrue Détermine si les instantanés doivent être traités dans un thread à faible priorité d’E/S.Determines whether or not to process snapshots in a low IO priority thread. La création d’une capture instantanée est une opération rapide, mais, pour charger une capture instantanée vers le service Débogueur de capture instantanée, celle doit d’abord être écrite sur le disque en tant que minidump.Creating a snapshot is a fast operation but, in order to upload a snapshot to the Snapshot Debugger service, it must first be written to disk as a minidump. Cela se produit dans le processus SnapshotUploader.That happens in the SnapshotUploader process. La définition de cette valeur sur true utilise des E/S de priorité basse pour écrire le minidump, qui n’est pas en concurrence avec votre application pour les ressources.Setting this value to true uses low-priority IO to write the minidump, which won't compete with your application for resources. Le réglage de cette valeur sur false accélère la création de minidumps au prix d'un ralentissement de votre application.Setting this value to false speeds up minidump creation at the expense of slowing down your application.
snapshotsPerDayLimitsnapshotsPerDayLimit 3030 Nombre maximal de captures instantanées autorisées dans une journée (24 heures).The maximum number of snapshots allowed in one day (24 hours). Cette limite est également appliquée du côté du service Application Insights.This limit is also enforced on the Application Insights service side. Les chargements sont limités à 50 par jour par application (autrement dit, par clé d’Instrumentation).Uploads are rate limited to 50 per day per application (that is, per instrumentation key). Cette valeur permet d’empêcher la création de captures instantanées supplémentaires qui seront finalement rejetées pendant le chargement.This value helps prevent creating additional snapshots that will eventually be rejected during upload. La valeur zéro supprime entièrement la limite, ce qui n’est pas recommandé.A value of zero removes the limit entirely, which isn't recommended.
snapshotsPerTenMinutesLimitsnapshotsPerTenMinutesLimit 11 Nombre maximal de captures instantanées autorisées en 10 minutes.The maximum number of snapshots allowed in 10 minutes. Bien qu'il n'y ait pas de limite supérieure à cette valeur, faites preuve de prudence en l’augmentant sur les charges de production car elle pourrait avoir un impact sur les performances de votre application.Although there is no upper bound on this value, exercise caution increasing it on production workloads because it could impact the performance of your application. La création d’une capture instantanée est rapide, mais la création d’un minidump de la capture instantanée et son chargement vers le service Débogueur de capture instantanée est une opération beaucoup plus lente qui entrera en concurrence avec votre application pour l’utilisation des ressources (à la fois UC et E-S).Creating a snapshot is fast, but creating a minidump of the snapshot and uploading it to the Snapshot Debugger service is a much slower operation that will compete with your application for resources (both CPU and I/O).
tempFoldertempFolder nullnull Spécifie le dossier dans lequel écrire les fichiers journaux des minidumps et du programme de chargement.Specifies the folder to write minidumps and uploader log files. S’il n’est pas défini, %TEMP%\Dumps est utilisé.If not set, then %TEMP%\Dumps is used.
thresholdForSnapshottingthresholdForSnapshotting 11 Nombre de fois où Application Insights doit voir une exception avant de demander des captures instantanées.How many times Application Insights needs to see an exception before it asks for snapshots.
uploaderProxyuploaderProxy nullnull Remplace le serveur proxy utilisé dans le processus du chargeur de captures instantanées.Overrides the proxy server used in the Snapshot Uploader process. Vous devrez peut-être utiliser ce paramètre si votre application se connecte à Internet via un serveur proxy.You may need to use this setting if your application connects to the internet via a proxy server. Le Snapshot Collector s’exécute dans le processus de votre application et utilise les mêmes paramètres de proxy.The Snapshot Collector runs within your application's process and will use the same proxy settings. Toutefois, le chargeur de captures instantanées s’exécute en tant que processus distinct et vous devrez peut-être configurer le serveur proxy manuellement.However, the Snapshot Uploader runs as a separate process and you may need to configure the proxy server manually. Si cette valeur est null, Snapshot Collector tentera de détecter automatiquement l’adresse du proxy en examinant System.Net.WebRequest.DefaultWebProxy et en transmettant la valeur au téléchargeur de captures instantanées.If this value is null, then Snapshot Collector will attempt to autodetect the proxy's address by examining System.Net.WebRequest.DefaultWebProxy and passing on the value to the Snapshot Uploader. Dans le cas contraire, la détection automatique n’est pas utilisée et le serveur proxy spécifié ici sera utilisé dans le téléchargeur de captures instantanées.If this value isn't null, then autodetection isn't used and the proxy server specified here will be used in the Snapshot Uploader.

cosmosDbcosmosDb

Le paramètre de configuration se trouve dans les déclencheurs et liaisons Cosmos DB.Configuration setting can be found in Cosmos DB triggers and bindings.

durableTaskdurableTask

Le paramètre de configuration se trouve dans les liaisons de Durable Functions.Configuration setting can be found in bindings for Durable Functions.

eventHubeventHub

Les paramètres de configuration se trouvent dans les déclencheurs et liaisons Event Hub.Configuration settings can be found in Event Hub triggers and bindings.

extensionsextensions

Propriété qui retourne un objet qui contient tous les paramètres spécifiques d’une liaison, tel que http et eventHub.Property that returns an object that contains all of the binding-specific settings, such as http and eventHub.

extensionBundleextensionBundle

Les offres groupées d’extensions vous permettent d’ajouter un jeu d’extensions de liaison Functions compatible avec votre application de fonction.Extension bundles let you add a compatible set of Functions binding extensions to your function app. Pour plus d’informations, voir Offres groupées d’extension pour développement local.To learn more, see Extension bundles for local development.

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[1.*, 2.0.0)"
    }
}

Les propriétés suivantes sont disponibles dans extensionBundle :The following properties are available in extensionBundle:

PropriétéProperty DescriptionDescription
idid Espace de noms pour les offres groupées d’extension Microsoft Azure Functions.The namespace for Microsoft Azure Functions extension bundles.
versionversion Version de l’offre groupée à installer.The version of the bundle to install. Le runtime Functions récupère toujours la version autorisée maximale définie par la plage ou l’intervalle de version.The Functions runtime always picks the maximum permissible version defined by the version range or interval. La valeur de version ci-dessus autorise toutes les versions d’offre groupée jusqu’à 1.0.0 mais sans inclure la version 2.0.0.The version value above allows all bundle versions from 1.0.0 up to but not including 2.0.0. Pour plus d’informations, consultez la notation d’intervalle de spécification de plages de versions.For more information, see the interval notation for specifying version ranges.

Les versions d’offre groupées sont incrémentées à mesure que les packages contenus dans l’offre groupée changent.Bundle versions increment as packages in the bundle change. Des changements de version majeure se produisent lorsque les packages de l’offre groupée passent à la version majeure supérieure.Major version changes occur when packages in the bundle increment by a major version. Les changements de version majeure dans l’offre groupée coïncident généralement avec ceux du runtime Functions.Major version changes in the bundle usually coincide with a change in the major version of the Functions runtime.

L’ensemble actuel d’extensions installées par l’offre groupée par défaut est énuméré dans ce fichier extensions.json.The current set of extensions installed by the default bundle is enumerated in this extensions.json file.

functionsfunctions

Liste des fonctions que l’hôte de travail exécute.A list of functions that the job host runs. Un tableau vide désigne l’exécution de toutes les fonctions.An empty array means run all functions. Utilisée uniquement pour une exécution locale.Intended for use only when running locally. Dans les applications de fonction dans Azure, vous devez plutôt suivre la procédure décrite dans Guide pratique pour désactiver des fonctions dans Azure Functions pour désactiver des fonctions spécifiques au lieu d’utiliser ce paramètre.In function apps in Azure, you should instead follow the steps in How to disable functions in Azure Functions to disable specific functions rather than using this setting.

{
    "functions": [ "QueueProcessor", "GitHubWebHook" ]
}

functionTimeoutfunctionTimeout

Indique la durée avant expiration du délai de toutes les fonctions.Indicates the timeout duration for all functions. Il suit le format de chaîne TimeSpan.It follows the timespan string format. Dans les plans de consommation serverless, la plage valide est comprise entre 1 seconde et 10 minutes, et la valeur par défaut est de 5 minutes.In a serverless Consumption plan, the valid range is from 1 second to 10 minutes, and the default value is 5 minutes.

Dans le plan Premium, la plage valide est comprise entre 1 seconde et 60 minutes, et la valeur par défaut est de 30 minutes.In the Premium plan, the valid range is from 1 second to 60 minutes, and the default value is 30 minutes.

Dans un plan App Service dédié, il n’existe aucune limite globale, et la valeur par défaut est de 30 minutes.In a Dedicated (App Service) plan, there is no overall limit, and the default value is 30 minutes. La valeur -1 indique une exécution illimitée, mais il est recommandé de conserver une limite supérieure fixe.A value of -1 indicates unbounded execution, but keeping a fixed upper bound is recommended.

{
    "functionTimeout": "00:05:00"
}

healthMonitorhealthMonitor

Paramètres de configuration de l’analyse d’intégrité d’hôtes.Configuration settings for Host health monitor.

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}
PropriétéProperty DefaultDefault DescriptionDescription
enabledenabled truetrue Indique si la fonctionnalité est activée.Specifies whether the feature is enabled.
healthCheckIntervalhealthCheckInterval 10 secondes10 seconds L’intervalle de temps entre les contrôles d’intégrité périodiques en arrière-plan.The time interval between the periodic background health checks.
healthCheckWindowhealthCheckWindow 2 minutes2 minutes Une fenêtre de temps coulissante utilisée conjointement au paramètre healthCheckThreshold.A sliding time window used in conjunction with the healthCheckThreshold setting.
healthCheckThresholdhealthCheckThreshold 66 Nombre maximal de fois où le contrôle d’intégrité peut échouer avant le lancement d’un recyclage de l’hôte.Maximum number of times the health check can fail before a host recycle is initiated.
counterThresholdcounterThreshold 0.800.80 Le seuil auquel un compteur de performance est considéré comme non intègre.The threshold at which a performance counter will be considered unhealthy.

httphttp

Les paramètres de configuration se trouvent dans les déclencheurs et liaisons HTTP.Configuration settings can be found in http triggers and bindings.

journalisationlogging

Contrôle les comportements de journalisation de l’application de fonction, y compris Application Insights.Controls the logging behaviors of the function app, including Application Insights.

"logging": {
    "fileLoggingMode": "debugOnly"
    "logLevel": {
      "Function.MyFunction": "Information",
      "default": "None"
    },
    "console": {
        ...
    },
    "applicationInsights": {
        ...
    }
}
PropriétéProperty DefaultDefault DescriptionDescription
fileLoggingModefileLoggingMode debugOnlydebugOnly Définit le niveau de journalisation de fichiers activé.Defines what level of file logging is enabled. Options : never, always, debugOnly.Options are never, always, debugOnly.
logLevellogLevel n/an/a Objet qui définit le filtrage par catégorie du journal pour les fonctions de l’application.Object that defines the log category filtering for functions in the app. Les versions 2.x et ultérieures suivent la disposition d’ASP.NET Core pour le filtrage des catégories du journal.Versions 2.x and later follow the ASP.NET Core layout for log category filtering. Ce paramètre vous permet de filtrer la journalisation pour des fonctions spécifiques.This setting lets you filter logging for specific functions. Pour plus d’informations, consultez Filtrage de journal dans la documentation ASP.NET Core.For more information, see Log filtering in the ASP.NET Core documentation.
consoleconsole n/an/a Le paramètre de journalisation de la console.The console logging setting.
applicationInsightsapplicationInsights n/an/a Le paramètre applicationInsights.The applicationInsights setting.

consoleconsole

Ce paramètre est un enfant de la journalisation.This setting is a child of logging. Il contrôle la journalisation de la console lorsque le mode débogage n’est pas activé.It controls the console logging when not in debugging mode.

{
    "logging": {
    ...
        "console": {
          "isEnabled": "false"
        },
    ...
    }
}
PropriétéProperty DefaultDefault DescriptionDescription
isEnabledisEnabled falsefalse Active ou désactive la journalisation de la console.Enables or disables console logging.

managedDependencymanagedDependency

La dépendance managée est une fonctionnalité qui est actuellement prise en charge uniquement par les fonctions basées sur PowerShell.Managed dependency is a feature that is currently only supported with PowerShell based functions. Elle permet au service de gérer automatiquement les dépendances.It enables dependencies to be automatically managed by the service. Lorsque la propriété enabled est définie sur true, le fichier requirements.psd1 est traité.When the enabled property is set to true, the requirements.psd1 file is processed. Les dépendances sont mises à jour lorsque des versions mineures sont publiées.Dependencies are updated when any minor versions are released. Pour plus d’informations, consultez la section Dépendance managée de l’article PowerShell.For more information, see Managed dependency in the PowerShell article.

{
    "managedDependency": {
        "enabled": true
    }
}

queuesqueues

Les paramètres de configuration se trouvent dans les déclencheurs et liaisons de la file d'attente de stockage.Configuration settings can be found in Storage queue triggers and bindings.

sendGridsendGrid

Le paramètre de configuration se trouve dans les déclencheurs et liaisons SendGrid.Configuration setting can be found in SendGrid triggers and bindings.

serviceBusserviceBus

Le paramètre de configuration se trouve dans les déclencheurs et liaisons Service Bus.Configuration setting can be found in Service Bus triggers and bindings.

singletonsingleton

Paramètres de configuration du comportement de verrouillage Singleton.Configuration settings for Singleton lock behavior. Pour plus d’informations, consultez l’article sur le problème de GitHub relatif à la prise en charge de singleton.For more information, see GitHub issue about singleton support.

{
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    }
}
PropriétéProperty DefaultDefault DescriptionDescription
lockPeriodlockPeriod 00:00:1500:00:15 Période pendant laquelle des verrous sont établis au niveau des fonctions.The period that function level locks are taken for. Les verrous se renouvellent automatiquement.The locks auto-renew.
listenerLockPeriodlistenerLockPeriod 00:01:0000:01:00 Période pendant laquelle des verrous sont établis au niveau des écouteurs.The period that listener locks are taken for.
listenerLockRecoveryPollingIntervallistenerLockRecoveryPollingInterval 00:01:0000:01:00 Intervalle de temps utilisé pour la récupération des verrous d’écouteurs si un verrou de ce type n’a pas pu être acquis au démarrage.The time interval used for listener lock recovery if a listener lock couldn't be acquired on startup.
lockAcquisitionTimeoutlockAcquisitionTimeout 00:01:0000:01:00 Période de temps maximale pendant laquelle le runtime essaie d’acquérir un verrou.The maximum amount of time the runtime will try to acquire a lock.
lockAcquisitionPollingIntervallockAcquisitionPollingInterval n/an/a Intervalle écoulé entre les tentatives d’acquisition de verrou.The interval between lock acquisition attempts.

versionversion

La chaîne de version "version": "2.0" est requise pour une application de fonction qui cible le runtime v2.The version string "version": "2.0" is required for a function app that targets the v2 runtime.

watchDirectorieswatchDirectories

Ensemble de répertoires de code partagé dont les modifications doivent être surveillées.A set of shared code directories that should be monitored for changes. Garantit que lorsque le code contenu dans ces répertoires est modifié, les changements sont récupérés par vos fonctions.Ensures that when code in these directories is changed, the changes are picked up by your functions.

{
    "watchDirectories": [ "Shared" ]
}

Étapes suivantesNext steps