Azure Functions 2.x 이상에 대한 host.json 참조

host.json 메타데이터 파일에는 함수 앱 인스턴스의 모든 함수에 영향을 주는 구성 옵션이 포함되어 있습니다. 이 문서에서는 Azure Functions 런타임의 버전 2.x부터 사용 가능한 설정을 나열합니다.

다른 함수 앱 구성 옵션은 함수 앱이 실행되는 위치에 따라 관리됩니다.

• Azure에 배포: 애플리케이션 설정에서
• 로컬 컴퓨터: local.settings.json 파일에서

바인딩과 관련된 host.json의 구성은 함수 앱의 각 함수에 동일하게 적용됩니다.

또한 애플리케이션 설정을 사용하여 환경별로 설정을 재정의하거나 적용할 수 있습니다.

샘플 host.json 파일

2.x 이상의 버전을 위한 다음 샘플 host.json 파일에는 가능한 모든 옵션이 지정되어 있습니다(내부용인 경우 제외).

{
    "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" ]
}

이 문서의 다음 섹션에서는 각 최상위 속성에 대해 설명합니다. 달리 명시되지 않을 경우 모두 선택 사항입니다.

aggregator

Application Insights에 대한 메트릭을 계산할 때 집계되는 함수 호출 수를 지정합니다.

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

함수 호출은 두 개의 한도 중 첫 번째 한에 도달할 때 집계됩니다.

applicationInsights

이 설정은 logging의 자식입니다.

샘플링 옵션을 비롯한 Application Insights 관련 옵션을 제어합니다.

전체 JSON 구조는 이전 host.json 예제 파일을 참조하세요.

applicationInsights.samplingSettings

이러한 설정에 대한 자세한 내용은 Application Insights의 샘플링을 참조하세요.

applicationInsights.httpAutoCollectionOptions

applicationInsights.dependencyTrackingOptions

applicationInsights.snapshotConfiguration

스냅샷에 대한 자세한 내용은 .NET 앱에서 예외에 대한 스냅샷 디버그하기 및 Application Insights 스냅샷 디버거 또는 스냅샷 보기를 사용 설정하는 문제 해결을 참조하세요.

blobs

구성 설정은 Storage Blob 트리거 및 바인딩에서 찾을 수 있습니다.

console

이 설정은 logging의 자식입니다. 디버깅 모드가 아닌 경우 콘솔 로깅을 제어합니다.

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

Azure Cosmos DB

구성 설정은 Azure Cosmos DB 트리거 및 바인딩에서 찾을 수 있습니다.

customHandler

사용자 지정 처리기에 대한 구성 설정입니다. 자세한 내용은 Azure Functions 사용자 지정 처리기를 참조하세요.

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

durableTask

구성 설정은 지속형 함수에 대한 바인딩에서 찾을 수 있습니다.

동시성

함수 앱에서 특정 바인딩에 대한 동적 동시성을 사용하도록 설정합니다. 자세한 내용은 동적 동시성을 참조하세요.

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

eventHub

구성 설정은 이벤트 허브 트리거 및 바인딩에서 찾을 수 있습니다.

확장

http, eventHub 등의 모든 바인딩 관련 설정이 포함된 개체를 반환하는 속성입니다.

extensionBundle

확장 번들을 사용하면 호환되는 함수 바인딩 확장 집합을 함수 앱에 추가할 수 있습니다. 자세히 알아보려면 로컬 개발용 확장 번들을 참조하세요.

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

extensionBundle에서 사용할 수 있는 속성은 다음과 같습니다.

functions

작업 호스트가 실행하는 함수 목록입니다. 빈 배열은 모든 함수를 실행한다는 의미입니다. 로컬로 실행할 때만 사용할 수 있습니다. Azure의 함수 앱에서는 이 설정을 사용하는 대신 Azure Functions에서 함수를 사용하지 않도록 설정하는 방법의 단계를 수행하여 특정 함수를 사용하지 않도록 설정해야 합니다.

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

functionTimeout

모든 함수 실행에 대한 시간 제한 기간을 나타냅니다. 이는 timespan 문자열 형식을 따릅니다.

¹ 프리미엄 플랜은 60분만 보장되지만 기술적으로는 제한이 없습니다.
² -1 값은 제한 없는 실행을 나타내지만 고정 상한을 유지하는 것이 좋습니다.

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

healthMonitor

호스트 상태 모니터에 대한 구성 설정

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

http

구성 설정은 http 트리거 및 바인딩에서 찾을 수 있습니다.

logging

Application Insights를 포함한 함수 앱의 로깅 동작을 제어합니다.

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

managedDependency

관리형 종속성은 현재 PowerShell 기반 함수에서만 지원되는 기능입니다. 이를 통해 서비스에서 종속성을 자동으로 관리할 수 있습니다. enabled 속성 true로 설정되면 requirements.psd1 파일이 처리됩니다. 부 버전이 릴리스되면 종속성이 업데이트됩니다. 자세한 내용은 PowerShell 문서의 관리형 종속성을 참조하세요.

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

queues

구성 설정은 스토리지 큐 트리거 및 바인딩에서 찾을 수 있습니다.

sendGrid

구성 설정은 SendGrid 트리거 및 바인딩에서 찾을 수 있습니다.

serviceBus

구성 설정은 Service Bus 트리거 및 바인딩에서 찾을 수 있습니다.

singleton

Singleton 잠금 동작에 대한 구성 설정입니다. 자세한 내용은 singleton 지원에 대한 GitHub 문제를 참조하세요.

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

telemetryMode

이 기능은 현재 미리 보기로 제공됩니다.

OpenTelemetry 출력 형식의 로그 및 추적 출력을 OpenTelemetry를 지원하는 하나 이상의 엔드포인트에 사용하도록 설정하는 데 사용됩니다. 이 설정을 설정하면 OpenTelemetryOpenTelemetry 출력이 사용됩니다. 기본적으로 이 설정이 없으면 모든 로그, 추적 및 이벤트가 표준 출력을 사용하여 Application Insights로 전송됩니다. 자세한 내용은 Azure Functions에서 OpenTelemetry 사용을 참조 하세요.

version

이 값은 host.json의 스키마 버전을 나타냅니다. v2 이상 버전의 런타임을 대상으로 하는 함수 앱에서는 버전 문자열 "version": "2.0"이 필수 항목입니다. v2와 v3 간의 host.json 스키마 변경 내용은 없습니다.

watchDirectories

변경 내용을 모니터링해야 하는 공유 코드 디렉터리 집합입니다. 이 디렉터리의 코드가 변경되면 변경 내용이 함수에 의해 선택되도록 합니다.

{
    "watchDirectories": [ "Shared" ]
}

watchFiles

애플리케이션을 다시 시작해야 하는 변경 내용을 모니터링하는 하나 이상의 파일 이름으로 이루어진 배열입니다. 이렇게 하면 이러한 파일의 코드가 변경되면 함수에서 업데이트를 선택합니다.

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

host.json 값 재정의

host.json 파일 자체는 변경하지 않고 특정 환경에 맞게 host.json 파일의 특정 설정을 구성하거나 수정할 인스턴스가 있을 수 있습니다. 애플리케이션 설정과 동일한 값을 생성하여 특정 host.json 값을 재정의할 수 있습니다. 런타임에서 AzureFunctionsJobHost__path__to__setting 형식의 애플리케이션 설정을 찾으면 JSON의 path.to.setting에 있는 해당 host.json 설정을 재정의합니다. 애플리케이션 설정으로 표현되는 경우 JSON 계층을 나타내는 데 사용되는 점(.)은 이중 밑줄(__)로 대체됩니다.

예를 들어 로컬로 실행할 때 Application Insight 샘플링을 사용하지 않도록 설정하려는 경우를 가정해 보겠습니다. 파일에서 로컬 host.json 파일을 변경하여 Application Insights를 사용하지 않도록 설정하면 배포 중에 이 변경 내용이 프로덕션 앱에 푸시될 수 있습니다. 이 작업을 수행하는 보다 안전한 방법은 대신 local.settings.json 파일에서 "AzureFunctionsJobHost__logging__applicationInsights__samplingSettings__isEnabled":"false"로 애플리케이션 설정을 만드는 것입니다. 다음 local.settings.json 파일에서 이를 확인할 수 있으며, 이 파일은 게시되지 않습니다.

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

환경 변수를 사용하여 host.json 설정을 재정의하는 것은 ASP.NET Core 명명 규칙을 따릅니다. 요소 구조에 배열이 포함된 경우 숫자 배열 인덱스는 이 경로의 추가 요소 이름으로 처리되어야 합니다. 자세한 내용은 환경 변수 이름 지정을 참조하세요.

다음 단계