Referencia de host.json para Azure Functions 2.x y versiones posteriores

Artículo
05/16/2024

El archivo de metadatos host.json contiene las opciones de configuración global que afectan a todas las funciones de dicha instancia de aplicación de funciones. En este artículo se enumeran los valores que están disponibles a partir de la versión 2.x del entorno en tiempo de ejecución de Azure Functions.

Nota

Este artículo trata sobre Azure Functions 2.x y versiones posteriores. Para obtener una referencia de host.json en Functions 1.x, consulte la referencia de host.json para Azure Functions, versión 1.x.

Otras opciones de configuración de la aplicación de funciones se administran según dónde se ejecute la aplicación de funciones:

Implementada en Azure: en la configuración de la aplicación.
En el equipo local: en el archivo local.settings.json.

Las configuraciones de host.json relacionadas con los enlaces se aplican por igual a cada función de la aplicación de funciones.

También puede invalidar o aplicar la configuración por entorno mediante la configuración de la aplicación.

Archivo host.json de ejemplo

El siguiente archivo host.json de ejemplo para la versión 2.x y posteriores tiene especificadas todas las opciones posibles (salvo aquellas que son solo para uso interno).

{
    "version": "2.0",
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    },
    "concurrency": { 
            "dynamicConcurrencyEnabled": true, 
            "snapshotPersistenceEnabled": true 
        },
    "extensions": {
        "blobs": {},
        "cosmosDb": {},
        "durableTask": {},
        "eventHubs": {},
        "http": {},
        "queues": {},
        "sendGrid": {},
        "serviceBus": {}
    },
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.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": 100.0, 
              "samplingPercentageIncreaseTimeout" : "00:00:01",
              "samplingPercentageDecreaseTimeout" : "00:00:01",
              "minSamplingPercentage": 0.1,
              "maxSamplingPercentage": 100.0,
              "movingAverageRatio": 1.0,
              "excludedTypes" : "Dependency;Event",
              "includedTypes" : "PageView;Trace"
            },
            "dependencyTrackingOptions": {
                "enableSqlCommandTextInstrumentation": true
            },
            "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"
    },
    "telemetryMode": "OpenTelemetry",
    "watchDirectories": [ "Shared", "Test" ],
    "watchFiles": [ "myFile.txt" ]
}

Las siguientes secciones de este artículo explican cada propiedad de nivel superior. Todas son opcionales, a menos que se indique lo contrario.

aggregator

Especifica cuántas llamadas a funciones se agregan cuando se calculan las métricas para Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}

Propiedad	Valor predeterminado	Descripción
batchSize	1000	Número máximo de solicitudes para agregar.
flushTimeout	00:00:30	Período máximo de tiempo para agregar.

Las llamadas a funciones se agregan cuando se alcanza el primero de los dos límites.

applicationInsights

Esta configuración es un elemento secundario de logging.

Controla las opciones de Application Insights, incluidas las opciones de muestreo.

Para obtener la estructura JSON completa, consulte el archivo host.json de ejemplo anterior.

Nota

Los muestreos de registros pueden provocar que algunas ejecuciones no aparezcan en la hoja de supervisión de Application Insights. Para evitar el muestreo de registros, agregue excludedTypes: "Request" al valor samplingSettings.

Propiedad	Valor predeterminado	Descripción
samplingSettings	N/D	Consulte applicationInsights.samplingSettings.
dependencyTrackingOptions	N/D	Consulte applicationInsights.dependencyTrackingOptions.
enableLiveMetrics	true	Habilita la colección de Live Metrics.
enableDependencyTracking	true	Habilita el seguimiento de dependencias.
enablePerformanceCountersCollection	true	Habilita la colección de contadores de rendimiento Kudu.
liveMetricsInitializationDelay	00:00:15	Solo para uso interno.
httpAutoCollectionOptions	N/D	Consulte applicationInsights.httpAutoCollectionOptions.
snapshotConfiguration	N/D	Consulte applicationInsights.snapshotConfiguration.

applicationInsights.samplingSettings

Para obtener más información acerca de esta configuración, vea Muestreo en Application Insights.

Propiedad	Valor predeterminado	Descripción
isEnabled	true	Habilita o deshabilita el muestreo.
maxTelemetryItemsPerSecond	20	Número de destino de los elementos de telemetría registrados por segundo en cada host de servidor. Si la aplicación se ejecuta en muchos hosts, reduzca este valor para que permanezca dentro de la tasa general de tráfico de destino.
evaluationInterval	01:00:00	Intervalo en el que se vuelve a evaluar la velocidad actual de telemetría. La evaluación se realiza como una media móvil. Se recomienda acortar este intervalo si la telemetría experimenta ráfagas repentinas.
initialSamplingPercentage	100.0	Porcentaje de muestreo inicial aplicado al inicio del proceso de muestreo para modificar dinámicamente el porcentaje. No lo reduzca durante la depuración.
samplingPercentageIncreaseTimeout	00:00:01	Cuando cambia el valor de porcentaje de muestreo, esta propiedad determina la próxima vez que se permite que Application Insights vuelva a aumentar el porcentaje de muestreo para capturar más datos.
samplingPercentageDecreaseTimeout	00:00:01	Cuando cambia el valor de porcentaje de muestreo, esta propiedad determina la próxima vez que se permite que Application Insights vuelva a reducir el porcentaje de muestreo para capturar menos datos.
minSamplingPercentage	0,1	A medida que el porcentaje de muestreo va variando, esta propiedad determina el porcentaje de muestreo mínimo permitido.
maxSamplingPercentage	100.0	A medida que el porcentaje de muestreo va variando, esta propiedad determina el porcentaje de muestreo máximo permitido.
movingAverageRatio	1.0	En el cálculo de la media móvil, peso asignado al valor más reciente. Use un valor igual o menor que 1. Los valores menores hacen que el algoritmo reaccione con menor agilidad a los cambios repentinos.
excludedTypes	null	Una lista delimitada por puntos y coma de tipos que no desea que se muestreen. Los tipos reconocidos son: `Dependency`, `Event`, `Exception`, `PageView`, `Request` y `Trace`. Todas las instancias de los tipos especificados se transmiten; los tipos no especificados se muestrean.
includedTypes	null	Una lista delimitada por puntos y coma de tipos que desea que se muestreen (con listas vacías se muestrean todos los tipos). El tipo que figura en `excludedTypes` invalida los tipos que se enumeran aquí. Los tipos reconocidos son: `Dependency`, `Event`, `Exception`, `PageView`, `Request` y `Trace`. Las instancias de los tipos especificados se muestrean; los tipos no especificados ni implícitos se transmiten sin muestrear.

applicationInsights.httpAutoCollectionOptions

Propiedad	Valor predeterminado	Descripción
enableHttpTriggerExtendedInfoCollection	true	Habilita o deshabilita la información de la solicitud HTTP extendida para los desencadenadores HTTP: encabezados de correlación de solicitud entrantes, compatibilidad con varias claves de instrumentación, método HTTP, ruta de acceso y respuesta.
enableW3CDistributedTracing	true	Habilita o deshabilita la compatibilidad del protocolo de seguimiento distribuido de W3C (y activa el esquema de correlación heredado). Está habilitado de forma predeterminada si el valor de `enableHttpTriggerExtendedInfoCollection` es true. Si `enableHttpTriggerExtendedInfoCollection` es false, esta marca se aplica solo a las solicitudes salientes, no a las entrantes.
enableResponseHeaderInjection	true	Habilita o deshabilita la inserción de encabezados de correlación de varios componentes en respuestas. La habilitación de la inyección permite a Application Insights construir un mapa de aplicación cuando se usan varias claves de instrumentación. Está habilitado de forma predeterminada si el valor de `enableHttpTriggerExtendedInfoCollection` es true. Esta configuración no se aplica si el valor de `enableHttpTriggerExtendedInfoCollection` es false.

applicationInsights.dependencyTrackingOptions

Propiedad	Valor predeterminado	Descripción
enableSqlCommandTextInstrumentation	false	Habilita la colección del texto completo de las consultas SQL, que está deshabilitada de forma predeterminada. Para más información sobre cómo recopilar texto de consultas SQL, consulte Seguimiento avanzado de SQL para obtener una consulta SQL completa.

applicationInsights.snapshotConfiguration

Para obtener más información sobre las instantáneas, vea los artículos sobre cómo depurar instantáneas cuando se producen excepciones en aplicaciones de .NET y solucionar problemas de habilitación del servicio Snapshot Debugger de Application Insights o ver instantáneas.

Propiedad	Valor predeterminado	Descripción
agentEndpoint	null	Punto de conexión utilizado para conectarse al servicio Snapshot Debugger de Application Insights. Si el valor es NULL, se utiliza un punto de conexión predeterminado.
captureSnapshotMemoryWeight	0.5	El peso dado al tamaño de memoria de proceso actual al comprobar si hay suficiente memoria para realizar una instantánea. El valor esperado es mayor que una fracción propia 0 (0 < CaptureSnapshotMemoryWeight < 1).
failedRequestLimit	3	Límite en el número de solicitudes con error para solicitar instantáneas antes de que se deshabilite el procesador de telemetría.
handleUntrackedExceptions	true	Habilita o deshabilita el seguimiento de las excepciones de las que la telemetría de Application Insights no realiza un seguimiento.
isEnabled	true	Habilita o deshabilita la recopilación de instantáneas.
isEnabledInDeveloperMode	false	Habilita o deshabilita la recopilación de instantáneas en el modo de desarrollador.
isEnabledWhenProfiling	true	Habilita o deshabilita la creación de instantáneas incluso si Application Insights Profiler está recopilando una sesión de generación de perfiles detallada.
isExceptionSnappointsEnabled	false	Habilita o deshabilita el filtrado de excepciones.
isLowPrioritySnapshotUploader	true	Determina si se debe ejecutar el proceso SnapshotUploader por debajo de la prioridad normal.
maximumCollectionPlanSize	50	El número máximo de problemas de los que podemos realizar un seguimiento en cualquier momento en un intervalo de 1 a 9999.
maximumSnapshotsRequired	3	Número máximo de instantáneas recopiladas para un único problema, en un intervalo de 1 a 999. Un problema se puede considerar como una instrucción throw individual en la aplicación. Una vez que el número de instantáneas recopiladas para un problema alcanza este valor, no se recopilarán más instantáneas para ese problema hasta que se restablezcan los contadores de problemas (vea `problemCounterResetInterval`) y se vuelva a alcanzar el límite de `thresholdForSnapshotting`.
problemCounterResetInterval	24:00:00	Frecuencia con la que se restablecen los contadores de problemas en un intervalo de 1 minuto a 7 días. Cuando se alcanza este intervalo, todos los recuentos de problemas se restablecen a cero. Problemas que ya han alcanzado el umbral para realizar instantáneas, pero que aún no han generado el número de instantáneas en `maximumSnapshotsRequired`; permanecen activas.
provideAnonymousTelemetry	true	Determina si se va a enviar la telemetría de uso y de errores anónimos a Microsoft. Esta telemetría se puede usar si se pone en contacto con Microsoft para ayudar a solucionar problemas con Snapshot Debugger. También se usa para supervisar los patrones de uso.
reconnectInterval	00:15:00	La frecuencia con la que se vuelve a conectar al punto de conexión de Snapshot Debugger. El intervalo permitido es de 1 minuto a 1 día.
shadowCopyFolder	null	Especifica la carpeta que se va a usar para los archivos binarios de copias sombra. Si no se establece, se prueban las carpetas especificadas por las siguientes variables de entorno en orden: Fabric_Folder_App_Temp, LOCALAPPDATA, APPDATA, TEMP.
shareUploaderProcess	true	Si es true, solo una instancia de SnapshotUploader recopilará y cargará las instantáneas de varias aplicaciones que compartan InstrumentationKey. Si se establece en false, el valor de SnapshotUploader será único para cada tupla (processName, InstrumentationKey).
snapshotInLowPriorityThread	true	Determina si se procesan o no las instantáneas en un subproceso de prioridad de E/S inferior. La creación de una instantánea es una operación rápida, pero para cargar una instantánea en el servicio Snapshot Debugger, primero debe escribirse en el disco como un minivolcado. Eso sucede en el proceso SnapshotUploader. Al establecer este valor en true, se usa la E/S de baja prioridad para escribir el minivolcado, que no compite por recursos con la aplicación. Si se establece este valor en false, se acelera la creación del minivolcado a costa de ralentizar la aplicación.
snapshotsPerDayLimit	30	Número máximo de instantáneas permitidas en 1 día (24 horas). Este límite también se aplica en el lado del servicio de Application Insights. Las cargas se limitan a 50 por día y por aplicación (es decir, por clave de instrumentación). Este valor ayuda a evitar la creación de instantáneas adicionales que finalmente se rechazarán durante la carga. Un valor de cero quita el límite por completo, lo que no se recomienda.
snapshotsPerTenMinutesLimit	1	Número máximo de instantáneas permitidas en 10 minutos. Aunque no haya ningún límite superior en este valor, tenga cuidado al aumentarlo en las cargas de trabajo de producción, ya que podría afectar al rendimiento de la aplicación. La creación de una instantánea es rápida, pero la creación de un minivolcado de la instantánea y su carga en el servicio Snapshot Debugger es una operación mucho más lenta que compite con la aplicación por los recursos (CPU y E/S).
tempFolder	null	Especifica la carpeta donde se escribirán los minivolcados y los archivos de registro del cargador. Si no se establece, se usa %TEMP%\Dumps.
thresholdForSnapshotting	1	Número de veces que Application Insights necesita ver una excepción antes de solicitar instantáneas.
uploaderProxy	null	Invalida el servidor proxy usado en el proceso del cargador de instantáneas. Es posible que tenga que usar esta opción si la aplicación se conecta a Internet a través de un servidor proxy. Snapshot Collector se ejecuta en el proceso de la aplicación y usará la misma configuración de proxy. Sin embargo, el cargador de instantáneas se ejecuta como un proceso independiente y puede que tenga que configurar el servidor proxy manualmente. Si este valor es NULL, Snapshot Collector intentará detectar automáticamente la dirección del proxy examinando `System.Net.WebRequest.DefaultWebProxy` y pasando el valor al cargador de instantáneas. Si este valor no es NULL, no se usa la detección automática y el servidor proxy especificado aquí se usará en el cargador de instantáneas.

blobs

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces de blobs de Storage.

console

Esta configuración es un elemento secundario de logging. Controla el registro de la consola cuando no está en modo de depuración.

{
    "logging": {
    ...
        "console": {
          "isEnabled": false,
          "DisableColors": true
        },
    ...
    }
}

Propiedad	Valor predeterminado	Descripción
DisableColors	false	Suprime el formato de registro en los registros de contenedor en Linux. Establezca el valor en true si ve caracteres de control ANSI no deseados en los registros de contenedor durante la ejecución en Linux.
isEnabled	false	Habilita o deshabilita el registro de la consola.

Azure Cosmos DB

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces de Azure Cosmos DB.

customHandler

Opciones de configuración para un controlador personalizado. Para más información, consulte Controladores personalizados de Azure Functions.

"customHandler": {
  "description": {
    "defaultExecutablePath": "server",
    "workingDirectory": "handler",
    "arguments": [ "--port", "%FUNCTIONS_CUSTOMHANDLER_PORT%" ]
  },
  "enableForwardingHttpRequest": false
}

Propiedad	Valor predeterminado	Descripción
defaultExecutablePath	N/D	Ejecutable que se va a iniciar como el proceso del controlador personalizado. Es una configuración obligatoria cuando se usan controladores personalizados y su valor es relativo a la raíz de la aplicación de funciones.
workingDirectory	raíz de aplicación de funciones	El directorio de trabajo en el que iniciar el proceso del controlador personalizado. Es una configuración opcional y su valor es relativo a la raíz de la aplicación de funciones.
argumentos	N/D	Matriz de argumentos de la línea de comandos que se van a pasar al proceso del controlador personalizado.
enableForwardingHttpRequest	false	Si se establece, todas las funciones que se componen solo de un desencadenador HTTP y la salida HTTP se reenvían a la solicitud HTTP original en lugar de la carga útil de solicitud del controlador personalizado.

durableTask

Las opciones de configuración se puede encontrar en los enlaces para Durable Functions.

simultaneidad

Habilita la simultaneidad dinámica para enlaces específicos en la aplicación de funciones. Para más información, consulte Simultaneidad dinámica.

    { 
        "concurrency": { 
            "dynamicConcurrencyEnabled": true, 
            "snapshotPersistenceEnabled": true 
        } 
    }

Propiedad	Valor predeterminado	Descripción
dynamicConcurrencyEnabled	false	Habilita los comportamientos de simultaneidad dinámica para todos los desencadenadores compatibles con esta característica, que está desactivado de forma predeterminada.
snapshotPersistenceEnabled	true	Los valores de simultaneidad aprendidos se conservan periódicamente en el almacenamiento para que las nuevas instancias empiecen a partir de esos valores en lugar de empezar a partir de 1 y tener que volver a hacer el aprendizaje.

eventHub

Las opciones de configuración se pueden encontrar en desencadenadores y enlaces del centro de eventos.

extensions

Propiedad que devuelve un objeto que contiene todas las configuraciones específicas de enlace, como http y eventHub.

extensionBundle

Las agrupaciones de extensiones permiten agregar un conjunto compatible de extensiones de enlace de Functions a la aplicación de funciones. Para obtener más información, consulte Agrupaciones de extensiones para el desarrollo local.

{
    "version": "2.0",
    "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
    }
}

Las siguientes propiedades están disponibles en extensionBundle:

Propiedad Descripción

id Espacio de nombres de las agrupaciones de extensiones de Microsoft Azure Functions.

version El rango de versión de la agrupación a instalar. Functions Runtime siempre elige la máxima versión permitida definida por el rango o intervalo de versiones. Por ejemplo, un rango de valor version de [4.0.0, 5.0.0) permite todas las versiones del conjunto desde la 4.0.0 en adelante, pero sin incluir la 5.0.0. Para más información, consulte la notación de intervalo para especificar intervalos de versiones.

Propiedad	Descripción
`id`	Espacio de nombres de las agrupaciones de extensiones de Microsoft Azure Functions.
`version`	El rango de versión de la agrupación a instalar. Functions Runtime siempre elige la máxima versión permitida definida por el rango o intervalo de versiones. Por ejemplo, un rango de valor `version` de `[4.0.0, 5.0.0)` permite todas las versiones del conjunto desde la 4.0.0 en adelante, pero sin incluir la 5.0.0. Para más información, consulte la notación de intervalo para especificar intervalos de versiones.

functions

Lista de las funciones que el host de trabajo ejecuta. Una matriz vacía significa ejecutar todas las funciones. Su uso está previsto solo cuando se ejecuta localmente. En cambio, en las aplicaciones de función de Azure, siga los pasos de Deshabilitamiento de funciones en Azure Functions para deshabilitar funciones específicas en lugar de usar esta configuración.

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

functionTimeout

Indica la duración del tiempo de espera para las ejecuciones de todas las funciones. Sigue el formato de cadena TimeSpan.

Tipo de plan	Predeterminado (min)	Máximo (min)
Consumo	5	10
Premium¹	30	-1 (sin enlazar)²
Dedicado (App Service)	30	-1 (sin enlazar)²

¹ La ejecución del plan Premium solo está garantizada durante 60 minutos, pero sin enlazar técnicamente.
² Un valor de -1 indica una ejecución sin enlazar, pero se recomienda mantener un límite superior fijo.

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

healthMonitor

Configuración del monitor de estado de host.

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}

Propiedad	Valor predeterminado	Descripción
enabled	true	Especifica si está habilitada la característica.
healthCheckInterval	10 segundos	El intervalo de tiempo entre las comprobaciones periódicas de mantenimiento en segundo plano.
healthCheckWindow	2 minutes	Una ventana de tiempo deslizante usada en combinación con el valor `healthCheckThreshold`.
healthCheckThreshold	6	Número máximo de veces que puede producirse un error en la comprobación de mantenimiento antes de que se inicie un reciclaje del host.
counterThreshold	0.80	El umbral en el que un contador de rendimiento se considerará incorrecto.

http

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces http.

logging

Controla los comportamientos de registro de la aplicación de función, Application Insights incluido.

"logging": {
    "fileLoggingMode": "debugOnly",
    "logLevel": {
      "Function.MyFunction": "Information",
      "default": "None"
    },
    "console": {
        ...
    },
    "applicationInsights": {
        ...
    }
}

Propiedad	Valor predeterminado	Descripción
fileLoggingMode	debugOnly	Determina el comportamiento del registro de archivos al ejecutarse en Azure. Las opciones son `never`, `always` y `debugOnly`. Esta configuración no se usa cuando la ejecución se realiza localmente. Cuando sea posible, debería usar Application Insights al depurar las funciones en Azure. El uso de `always` afecta negativamente al comportamiento de arranque en frío de la aplicación y al rendimiento de los datos. La configuración de `debugOnly` predeterminada genera archivos de registro al realizar la depuración con Azure Portal.
logLevel	N/D	Objeto que define el filtrado por categoría de registro para las funciones de la aplicación. Esta configuración permite el filtrado del registro de funciones específicas. Para más información, consulte Configuración de los niveles de registro.
console	N/D	Configuración del registro de consola.
applicationInsights	N/D	Configuración de applicationInsights.

managedDependency

La dependencia administrada es una característica en versión preliminar que actualmente solo se admite con funciones basadas en PowerShell. Permite que el servicio administre de forma automática las dependencias. Cuando la propiedad enabled está establecida en true, se procesa el archivo requirements.psd1. Las dependencias se actualizarán cuando se publique alguna versión secundaria. Para obtener más información, lea Dependencia administrada en el artículo de PowerShell.

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

queues

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces de la cola de Storage.

sendGrid

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces de SendGrid.

serviceBus

Las opciones de configuración se pueden encontrar en los desencadenadores y enlaces de Service Bus.

singleton

Opciones de configuración para el comportamiento de bloqueo Singleton. Para más información, consulte problema de compatibilidad de GitHub con singleton.

{
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    }
}

Propiedad	Valor predeterminado	Descripción
lockPeriod	00:00:15	Período durante el cual se producen los bloqueos de nivel de función. Los bloqueos se renuevan automáticamente.
listenerLockPeriod	00:01:00	Período durante el cual se producen los bloqueos de agente de escucha.
listenerLockRecoveryPollingInterval	00:01:00	Intervalo de tiempo que se utiliza para la recuperación de bloqueos del agente de escucha si no se pudo adquirir un bloqueo de agente de escucha durante el inicio.
lockAcquisitionTimeout	00:01:00	Cantidad máxima de tiempo que el entorno en tiempo de ejecución intentará adquirir un bloqueo.
lockAcquisitionPollingInterval	N/D	Intervalo entre intentos de adquisición de bloqueo.

telemetryMode

Esta característica está actualmente en versión preliminar.

Se usa para habilitar la salida de registros y seguimientos en un formato de salida de OpenTelemetry en uno o varios puntos de conexión que admiten OpenTelemetry. Cuando esta configuración se establece OpenTelemetryen , se usa la salida de OpenTelemetry. De forma predeterminada sin esta configuración, todos los registros, seguimientos y eventos se envían a Application Insights mediante las salidas estándar. Para más información, consulte Uso de OpenTelemetry con Azure Functions.

version

Este valor indica la versión de esquema de host.json. La cadena de versión "version": "2.0" es necesaria para una aplicación de funciones que tenga como destino la versión v2 o posterior del entorno de ejecución. No hay cambios en el esquema host.json entre las versiones 2 y 3.

watchDirectories

Conjunto de directorios de código compartido en los que se deben supervisar los cambios. Garantiza que cuando se cambie el código en estos directorios, las funciones recibirán los cambios.

{
    "watchDirectories": [ "Shared" ]
}

watchFiles

Matriz de uno o más nombres de archivos que se supervisan para ver los cambios que requieren que se reinicie la aplicación. Garantiza que cuando se cambie el código en estos archivos, las funciones recibirán las actualizaciones.

{
    "watchFiles": [ "myFile.txt" ]
}

Invalidación de valores de host.json

Puede haber instancias en las que quiera configurar o modificar valores específicos en un archivo host.json para un entorno específico, sin cambiar el propio archivo host.json. Puede invalidar valores específicos de host.json al crear un valor equivalente como una configuración de aplicación. Cuando el entorno de ejecución encuentra una configuración de aplicación en el formato AzureFunctionsJobHost__path__to__setting, invalida la configuración de host.json equivalente que se encuentra en path.to.setting en el archivo JSON. Cuando se expresa como una configuración de aplicación, el punto (.), que se utilizaba para indicar la jerarquía JSON, se reemplaza por un carácter de subrayado doble (__).

Por ejemplo, suponga que desea deshabilitar el muestreo de Application Insights cuando se ejecuta localmente. Si ha cambiado el archivo host.json local para deshabilitar Application Insights, este cambio podría insertarse en la aplicación de producción durante la implementación. La manera más segura de hacerlo es crear una configuración de aplicación como "AzureFunctionsJobHost__logging__applicationInsights__samplingSettings__isEnabled":"false" en el archivo local.settings.json. Puede verlo en el siguiente archivo local.settings.json, que no se publica:

{
    "IsEncrypted": false,
    "Values": {
        "AzureWebJobsStorage": "{storage-account-connection-string}",
        "FUNCTIONS_WORKER_RUNTIME": "{language-runtime}",
        "AzureFunctionsJobHost__logging__applicationInsights__samplingSettings__isEnabled":"false"
    }
}

Anule la configuración de host.json mediante variables de entorno que siguen las convenciones de nomenclatura de ASP.NET Core. Cuando la estructura del elemento incluye una matriz, el índice de la matriz se debe tratar como un nombre de elemento adicional en esta ruta de acceso. Para más información, consulte las variables de entorno de nomenclatura.

Pasos siguientes

Vea cómo actualizar el archivo host.json

Consulte las opciones de configuración global en las variables de entorno

Compartir a través de