Referência ao host.json para Azure Functions 2.x e versões posteriores

O arquivo de metadados host.json contém opções de configuração que afetam todas as funções de uma instância de aplicativo de funções. Este artigo lista as configurações que estão disponíveis a partir da versão 2.x do Azure Functions Runtime.

Observação

Este artigo serve para o Azure Functions 2.x e versões mais recentes. Para obter uma referência de host.json no Functions 1.x, confira Referência de host.json para o Azure Functions 1.x.

Outras opções de configuração do aplicativo de funções são gerenciadas dependendo de onde o aplicativo de funções é executado:

As configurações no host.json relacionadas às associações são aplicadas igualmente a cada função no aplicativo de funções.

Você também pode substituir ou aplicar configurações por ambiente usando as configurações de aplicativo.

Arquivo host.json de exemplo

O arquivo host.json de exemplo a seguir para a versão 2.x+ tem todas as opções possíveis especificadas (excluindo as de apenas para uso interno).

{
    "version": "2.0",
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    },
    "extensions": {
        "blobs": {},
        "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": 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"
            },
            "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
    },
    "retry": {
      "strategy": "fixedDelay",
      "maxRetryCount": 5,
      "delayInterval": "00:00:05"
    },
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    },
    "watchDirectories": [ "Shared", "Test" ],
    "watchFiles": [ "myFile.txt" ]
}

As seções seguintes deste artigo explicam cada propriedade de nível superior. Todas são opcionais, a menos que seja indicado o contrário.

agregador

Especifica quantas invocações de função são agregadas ao calcular métricas para o Application Insights.

{
    "aggregator": {
        "batchSize": 1000,
        "flushTimeout": "00:00:30"
    }
}
Propriedade Padrão Descrição
batchSize 1000 Número máximo de solicitações para agregação.
flushTimeout 00:00:30 Período de tempo máximo para agregação.

As invocações de função são agregadas quando o primeiro dos dois limites é atingido.

applicationInsights

Essa configuração é a filha de Registro em log.

Controla opções para o Application Insights, incluindo opções de amostragem.

Para obter a estrutura JSON completa, confira o arquivo host.json de exemplo anterior.

Observação

A amostragem de log pode fazer com que algumas execuções não apareçam na folha do Monitor do Application Insights. Para evitar a amostragem de log, adicione excludedTypes: "Request" ao valor samplingSettings.

Propriedade Padrão Descrição
samplingSettings N/D Confira applicationInsights.samplingSettings.
enableLiveMetrics true Habilita a coleta de métricas em tempo real.
enableDependencyTracking true Habilita o acompanhamento de dependência.
enablePerformanceCountersCollection true Habilita a coleta de contadores de desempenho Kudu.
liveMetricsInitializationDelay 00:00:15 Somente para uso interno.
httpAutoCollectionOptions N/D Confira applicationInsights.httpAutoCollectionOptions.
snapshotConfiguration N/D Confira applicationInsights.snapshotConfiguration.

applicationInsights.samplingSettings

Para obter mais informações sobre essas configurações, confira Amostragem no Application Insights.

Propriedade Padrão Descrição
isEnabled true Habilita ou desabilita a amostragem.
maxTelemetryItemsPerSecond 20 O número de destino de itens de telemetria registrados por segundo em cada host do servidor. Se o aplicativo for executado em vários hosts, reduza esse valor para permanecer dentro da taxa de destino de tráfego geral.
evaluationInterval 01:00:00 O intervalo no qual a taxa atual de telemetria é reavaliada. Avaliação é executada como uma média móvel. Talvez você queira reduzir esse intervalo se a sua telemetria estiver sujeita a picos repentinos.
initialSamplingPercentage 100.0 A porcentagem de amostragem inicial aplicada no início do processo de amostragem para variar a porcentagem de forma dinâmica. Não reduza o valor enquanto estiver depurando.
samplingPercentageIncreaseTimeout 00:00:01 Quando o valor da porcentagem de amostragem é alterado, essa propriedade determina quanto tempo depois o Application Insights tem permissão para aumentar a porcentagem de amostragem novamente para capturar mais dados.
samplingPercentageDecreaseTimeout 00:00:01 Quando o valor da porcentagem de amostragem é alterado, essa propriedade determina quanto tempo depois o Application Insights tem permissão para reduzir a porcentagem de amostragem novamente para capturar menos dados.
minSamplingPercentage 0,1 Conforme a porcentagem de amostragem varia, essa propriedade determina a porcentagem de amostragem mínima permitida.
maxSamplingPercentage 100.0 Conforme a porcentagem de amostragem varia, essa propriedade determina a porcentagem de amostragem máxima permitida.
movingAverageRatio 1.0 No cálculo da média móvel, o peso atribuído ao valor mais recente. Use um valor menor ou igual a 1. Valores menores tornam o algoritmo menos reativo a mudanças repentinas.
excludedTypes nulo Uma lista delimitada por ponto-e-vírgula dos tipos que você não quer usar como amostra. Os tipos reconhecidos são Dependency, Event, Exception, PageView, Request e Trace. Todas as instâncias dos tipos especificados são transmitidas; os tipos não especificados são usados como amostra.
includedTypes nulo Uma lista delimitada por ponto-e-vírgula dos tipos que você deseja que sejam amostrados; uma lista vazia implica todos os tipos. O tipo listado em excludedTypes substitui os tipos listados aqui. Os tipos reconhecidos são Dependency, Event, Exception, PageView, Request e Trace. As instâncias dos tipos especificados são amostradas; os tipos não especificados ou implicados são transmitidos sem amostragem.

applicationInsights.httpAutoCollectionOptions

Propriedade Padrão Descrição
enableHttpTriggerExtendedInfoCollection true Habilita ou desabilita informações de solicitação HTTP estendidas para gatilhos HTTP: cabeçalhos de correlação de solicitação de entrada, suporte para chaves de várias instrumentações, método HTTP, caminho e resposta.
enableW3CDistributedTracing true Habilita ou desabilita o suporte do protocolo de rastreamento distribuído W3C (e ativa o esquema de correlação herdado). Habilitado por padrão se enableHttpTriggerExtendedInfoCollection for true. Se enableHttpTriggerExtendedInfoCollection for false, esse sinalizador se aplicará somente a solicitações de saída e não a solicitações de entrada.
enableResponseHeaderInjection true Habilita ou desabilita a injeção de cabeçalhos de correlação de vários componentes em respostas. Habilitar a injeção permite que o Application Insights crie um mapa de aplicativo para quando várias chaves de instrumentação são usadas. Habilitado por padrão se enableHttpTriggerExtendedInfoCollection for true. Essa configuração não se aplica se enableHttpTriggerExtendedInfoCollection for false.

applicationInsights.snapshotConfiguration

Para obter mais informações sobre instantâneos, confira Depurar instantâneos em exceções nos aplicativos .NET e Solucionar problemas ao habilitar o Depurador de Instantâneos do Application Insights ou ao exibir instantâneos.

Propriedade Padrão Descrição
agentEndpoint nulo O ponto de extremidade usado para se conectar ao serviço de Depurador de Instantâneos do Application Insights. Se for null, será usado um ponto de extremidade padrão.
captureSnapshotMemoryWeight 0,5 O peso dado ao tamanho da memória do processo atual ao verificar se há memória suficiente para tirar um instantâneo. O valor esperado é maior que a fração apropriada 0 (0 < CaptureSnapshotMemoryWeight < 1).
failedRequestLimit 3 O limite do número de solicitações com falha para solicitar instantâneos antes que o processador de telemetria seja desabilitado.
handleUntrackedExceptions true Habilita ou desabilita o rastreamento de exceções que não são rastreadas pela telemetria do Application Insights.
isEnabled true Habilita ou desabilita a coleta de instantâneo
isEnabledInDeveloperMode false Habilita ou desabilita a coleta de instantâneo habilitada no modo de desenvolvedor.
isEnabledWhenProfiling true Habilita ou desabilita a criação de instantâneos, mesmo se o Application Insights Profiler estiver coletando uma sessão detalhada de criação de perfil.
isExceptionSnappointsEnabled false Habilita ou desabilita a filtragem de exceções.
isLowPrioritySnapshotUploader true Determina se o processo SnapshotUploader deve ser executado na prioridade abaixo do normal.
maximumCollectionPlanSize 50 O número máximo de problemas que podemos rastrear a qualquer momento em um intervalo de um a 9999.
maximumSnapshotsRequired 3 O número máximo de instantâneos coletados para um único problema, em um intervalo de um a 999. Um problema pode ser considerado uma instrução de lançamento individual no aplicativo. Depois que o número de instantâneos coletados para um problema atingir esse valor, nenhum instantâneo será coletado para esse problema até que os contadores de problema sejam redefinidos (confira problemCounterResetInterval) e o limite thresholdForSnapshotting seja atingido novamente.
problemCounterResetInterval 24:00:00 A frequência com que os contadores de problema devem ser redefinidos em um intervalo de um minuto a sete dias. Quando esse intervalo for atingido, todas as contagens de problemas serão redefinidas para zero. Problemas existentes que já atingiram o limite para fazer instantâneos, mas que ainda não geraram o número de instantâneos em maximumSnapshotsRequired, permanecem ativos.
provideAnonymousTelemetry true Determina se o uso anônimo e a telemetria de erro devem ser enviados à Microsoft. Essa telemetria poderá ser usada se você entrar em contato com a Microsoft para ajudar a solucionar problemas com o Depurador de Instantâneos. Ela também é usada para monitorar padrões de uso.
reconnectInterval 00:15:00 A frequência com que reconectamos ao ponto de extremidade do Depurador de Instantâneos. O intervalo permitido é de um minuto a um dia.
shadowCopyFolder nulo Especifica a pasta a ser usada para binários de cópia de sombra. Se não estiver definido, as pastas especificadas pelas seguintes variáveis de ambiente serão tentadas em ordem: Fabric_Folder_App_Temp, LOCALAPPDATA, APPDATA, TEMP.
shareUploaderProcess true Se for true, apenas uma instância de SnapshotUploader coletará e carregará instantâneos para vários aplicativos que compartilham o InstrumentationKey. Se definido como false, o SnapshotUploader será exclusivo para cada tupla (ProcessName, InstrumentationKey).
snapshotInLowPriorityThread true Determina se os instantâneos devem ou não ser processados em um thread de prioridade baixa de E/S. A criação de um instantâneo é uma operação rápida. No entanto, para carregar um instantâneo no serviço de Depurador de Instantâneos, ele deve ser gravado primeiro no disco como um minidespejo. Isso acontece no processo SnapshotUploader. Definir esse valor como true usa E/S de baixa prioridade para gravar o minidespejo, que não competirá com o aplicativo por recursos. Definir esse valor como false acelera a criação de minidespejo em detrimento da desaceleração do seu aplicativo.
snapshotsPerDayLimit 30 O número máximo de instantâneos permitido em um dia (24 horas). Esse limite também é imposto no lado do serviço do Application Insights. Os carregamentos têm uma taxa limitada a 50 por dia por aplicativo (por chave de instrumentação). Esse valor ajuda a impedir a criação de instantâneos adicionais que eventualmente serão rejeitados durante o carregamento. Um valor de zero remove totalmente o limite, o que não é recomendado.
snapshotsPerTenMinutesLimit 1 O número máximo de instantâneos permitido em 10 minutos. Embora não exista limite superior nesse valor, cuidado ao aumentá-lo nas cargas de trabalho de produção, pois isso pode afetar o desempenho do aplicativo. Criar um instantâneo é rápido, mas criar um minidespejo do instantâneo e carregá-lo para o serviço de Depurador de Instantâneos é uma operação muito mais lenta que competirá com o aplicativo por recursos (CPU e E/S).
tempFolder nulo Especifica a pasta para gravar minidespejos e arquivos de log do carregador. Se não for definido, %TEMP%\Dumps será usado.
thresholdForSnapshotting 1 A quantidade de vezes que o Application Insights precisa ver uma exceção antes de solicitar instantâneos.
uploaderProxy nulo Substitui o servidor proxy usado no processo de Snapshot Uploader. Talvez seja necessário usar essa configuração se o aplicativo se conectar à Internet por meio de um servidor proxy. O Snapshot Collector é executado no processo do aplicativo e usará as mesmas configurações de proxy. No entanto, o Snapshot Uploader é executado como um processo separado e talvez seja necessário configurar o servidor proxy manualmente. Se esse valor for null, o Snapshot Collector tentará detectar automaticamente o endereço do proxy ao examinar System.Net.WebRequest.DefaultWebProxy e passar o valor para o Snapshot Uploader. Se esse valor não for null, a detecção automática não será usada e o servidor proxy especificado aqui deverá ser usado no Snapshot Uploader.

blobs

As definições de configuração podem ser encontradas em Associações e gatilhos de blob de armazenamento.

console

Essa configuração é a filha de Registro em log. Ela controla o log do console quando não está no modo de depuração.

{
    "logging": {
    ...
        "console": {
          "isEnabled": false,
          "DisableColors": true
        },
    ...
    }
}
Propriedade Padrão Descrição
DisableColors false Suprime a formatação de log nos logs de contêiner no Linux. Defina como verdadeiro se você estiver vendo caracteres de controle ANSI indesejados nos logs de contêiner ao executar no Linux.
isEnabled false Habilita ou desabilita o log de console.

cosmosDb

A definição de configuração pode ser encontrada em Associações e gatilhos do Cosmos DB.

customHandler

Definições de configuração para um manipulador personalizado. Para obter mais informações, confira Manipuladores personalizados do Azure Functions.

"customHandler": {
  "description": {
    "defaultExecutablePath": "server",
    "workingDirectory": "handler",
    "arguments": [ "--port", "%FUNCTIONS_CUSTOMHANDLER_PORT%" ]
  },
  "enableForwardingHttpRequest": false
}
Propriedade Padrão Descrição
defaultExecutablePath N/D O executável a ser iniciado como o processo de manipulador personalizado. É uma configuração necessária ao usar manipuladores personalizados e o valor é relativo à raiz do aplicativo de funções.
workingDirectory raiz do aplicativo de funções O diretório de trabalho no qual iniciar o processo de manipulador personalizado. É uma configuração opcional e o valor é relativo à raiz do aplicativo de funções.
argumentos N/D Uma matriz de argumentos de linha de comando para passar para o processo de manipulador personalizado.
enableForwardingHttpRequest false Se definido, todas as funções que consistem apenas em um gatilho HTTP e saída HTTP serão encaminhadas para a solicitação HTTP original em vez do conteúdo de solicitação do manipulador personalizado.

durableTask

A definição de configuração pode ser encontrada em Associações para Durable Functions.

eventHub

As definições de configuração podem ser encontradas em Associações e gatilhos do Hub de Eventos.

extensions

Propriedade que retorna um objeto que contém todas as configurações específicas de associação, como http e eventHub.

extensionBundle

Os pacotes de extensão permitem que você adicione um conjunto compatível de extensões de associação de funções ao aplicativo de funções. Para saber mais, confira Pacotes de extensão para o desenvolvimento local.

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

As propriedades a seguir estão disponíveis em extensionBundle:

Propriedade Descrição
id O namespace dos pacotes de extensão do Microsoft Azure Functions.
version A versão do pacote a ser instalado. O runtime do Functions sempre escolhe a versão máxima permitida definida pelo intervalo de versões. O valor de versão acima permite todas as versões de pacote da 2.0.0 até a 3.0.0, mas sem incluir a última. Para obter mais informações, confira a notação de intervalo para especificar intervalos de versões.

funções

Uma lista de funções que o host de trabalho executa. Uma matriz vazia significa que todas as funções serão executadas. Para uso somente quando em execução localmente. Em aplicativos de funções no Azure, você deve seguir as etapas em Como desabilitar funções no Azure Functions para desabilitar funções específicas em vez de usar essa configuração.

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

functionTimeout

Indica a duração do tempo limite para todas as funções. Ele segue o formato de cadeia de caracteres de intervalo de tempo.

Tipo de plano Padrão (mín.) Máximo (mín.)
Consumo 5 10
Premium1 30 -1 (não associado)2
Dedicado (Serviço de Aplicativo) 30 -1 (não associado)2

1 A execução do plano Premium só é garantida por 60 minutos, mas é, tecnicamente, desassociada.
2 Um valor de -1 indica a execução não associada, mas é recomendável manter um limite superior fixo.

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

healthMonitor

Definições de configuração para monitor de integridade de Host.

{
    "healthMonitor": {
        "enabled": true,
        "healthCheckInterval": "00:00:10",
        "healthCheckWindow": "00:02:00",
        "healthCheckThreshold": 6,
        "counterThreshold": 0.80
    }
}
Propriedade Padrão Descrição
Habilitado true Especifica se o recurso está habilitado.
healthCheckInterval 10 segundos O intervalo de tempo entre as verificações de integridade em segundo plano.
healthCheckWindow 2 minutos Uma janela de tempo deslizante usada em conjunto com a configuração healthCheckThreshold.
healthCheckThreshold 6 Número máximo de vezes que a verificação de integridade pode falhar antes de uma reciclagem de host ser iniciada.
counterThreshold 0.80 O limite no qual um contador de desempenho será considerado não íntegro.

http

As definições de configuração podem ser encontradas em Associações e gatilhos HTTP.

registro em log

Controla os comportamentos de registro em log do aplicativo de funções, incluindo o Application Insights.

"logging": {
    "fileLoggingMode": "debugOnly",
    "logLevel": {
      "Function.MyFunction": "Information",
      "default": "None"
    },
    "console": {
        ...
    },
    "applicationInsights": {
        ...
    }
}
Propriedade Padrão Descrição
fileLoggingMode debugOnly Define qual nível de log de arquivos está habilitado. As opções são: never, always e debugOnly.
logLevel N/D Objeto que define a filtragem da categoria de log para funções no aplicativo. Essa configuração permite filtrar o registro para funções específicas. Para saber mais, confira Configurar níveis de registro em log.
console N/D A configuração de log do console.
applicationInsights N/D A configuração applicationInsights.

managedDependency

A dependência gerenciada é um recurso que atualmente só tem suporte com funções baseadas no PowerShell. Ele permite que as dependências sejam gerenciadas automaticamente pelo serviço. Quando a propriedade enabled é definida como true, o arquivo requirements.psd1 é processado. As dependências serão atualizadas quando qualquer versão secundária for lançada. Para obter mais informações, confira Dependência gerenciada no artigo sobre PowerShell.

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

filas

As definições de configuração podem ser encontradas em Associações e gatilhos da fila de armazenamento.

tentar novamente

Controla as opções de política de repetição para todas as execuções no aplicativo.

{
    "retry": {
        "strategy": "fixedDelay",
        "maxRetryCount": 2,
        "delayInterval": "00:00:03"  
    }
}
Propriedade Padrão Descrição
estratégia nulo Obrigatórios. Usar qual estratégia de repetição. Os valores válidos são fixedDelay ou exponentialBackoff.
maxRetryCount nulo Obrigatórios. O número máximo de repetições permitidas por execução de função. -1 significa repetir indefinidamente.
delayInterval nulo O atraso usado entre as repetições com uma estratégia fixedDelay.
minimumInterval nulo O atraso mínimo de repetição ao usar a estratégia exponentialBackoff.
maximumInterval nulo O atraso máximo de repetição ao usar a estratégia exponentialBackoff.

sendGrid

A definição de configuração pode ser encontrada em Associações e gatilhos do SendGrid.

serviceBus

A definição de configuração pode ser encontrada em Associações e gatilhos do Barramento de Serviço.

singleton

Parâmetro de configuração para o comportamento de bloqueio de Singleton. Para obter mais informações, consulte Problema com o GitHub referente ao suporte de singleton.

{
    "singleton": {
      "lockPeriod": "00:00:15",
      "listenerLockPeriod": "00:01:00",
      "listenerLockRecoveryPollingInterval": "00:01:00",
      "lockAcquisitionTimeout": "00:01:00",
      "lockAcquisitionPollingInterval": "00:00:03"
    }
}
Propriedade Padrão Descrição
lockPeriod 00:00:15 O período em que ocorrem os bloqueios de nível de função. Os bloqueios têm renovação automática.
listenerLockPeriod 00:01:00 O período em que ocorrem os bloqueios de ouvinte.
listenerLockRecoveryPollingInterval 00:01:00 O intervalo de tempo usado para a recuperação do bloqueio de ouvinte caso não tenha sido possível adquirir um bloqueio de ouvinte durante a inicialização.
lockAcquisitionTimeout 00:01:00 A quantidade máxima de tempo em que o runtime tenta adquirir um bloqueio.
lockAcquisitionPollingInterval N/D O intervalo entre as tentativas de aquisição de bloqueio.

version

Esse valor indica a versão do esquema de host.json. A cadeia de caracteres de versão "version": "2.0" é necessária para um aplicativo de funções que segmente o runtime v2 ou uma versão mais recente. Não há alterações de esquema do host.json entre v2 e v3.

watchDirectories

Um conjunto de diretórios de código compartilhado que devem ser monitorados quanto a alterações. Garante que, quando o código nesses diretórios é alterado, as alterações sejam coletadas pelas funções.

{
    "watchDirectories": [ "Shared" ]
}

watchFiles

Uma matriz de um ou mais nomes de arquivos que são monitorados para alterações que exigem que o aplicativo seja reiniciado. Isso garante que quando o código desses arquivos for alterado, as atualizações serão coletadas pelas funções.

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

Substituir valores de host.json

Pode haver instâncias em que você deseja configurar ou modificar configurações específicas em um arquivo host.json para um ambiente específico, sem alterar o próprio arquivo host.json. Você pode substituir valores de host.json específicos ao criar um valor equivalente como uma configuração de aplicativo. Quando o runtime encontra uma configuração de aplicativo no formato AzureFunctionsJobHost__path__to__setting, ele substitui a configuração host.json equivalente na configuração localizada em path.to.setting no JSON. Quando expressa como uma configuração de aplicativo, o ponto (.) usado para indicar a hierarquia JSON é substituído por um sublinhado duplo (__).

Por exemplo, digamos que você queira desabilitar a amostragem do Application Insight ao fazer a execução no local. Se você alterou o arquivo host.json local para desabilitar o Application Insights, essa alteração poderá ser enviada por push ao aplicativo de produção durante a implantação. No entanto, a maneira mais segura de fazer isso é criar uma configuração de aplicativo como "AzureFunctionsJobHost__logging__applicationInsights__samplingSettings__isEnabled":"false" no arquivo local.settings.json. Você pode ver isso no seguinte arquivo local.settings.json, que não é publicado:

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

Próximas etapas