Azure Functions의 타이머 트리거

이 문서에서는 Azure Functions에서 타이머 트리거를 사용하는 방법을 설명합니다. 타이머 트리거를 사용하면 일정에 따라 함수를 실행할 수 있습니다.

Azure Functions 개발자를 위한 참조 정보입니다. Azure Functions를 새로 사용하는 경우 다음 리소스로 시작합니다.

• Azure Functions 개발자 참조

• Azure Functions 트리거 및 바인딩 개념

• Azure Functions를 로컬에서 코딩 및 테스트

타이머 트리거 함수를 수동으로 실행하는 방법에 대한 자세한 내용은 HTTP 트리거가 아닌 함수를 수동으로 실행하는 방법을 참조 하세요.

이 바인딩에 대한 지원은 모든 개발 환경에서 자동으로 제공됩니다. 패키지를 수동으로 설치하거나 확장을 등록할 필요는 없습니다.

타이머 확장 패키지의 소스 코드는 azure-webjobs-sdk-extensions GitHub 리포지토리에 있습니다.

예시

//<docsnippet_fixed_delay_retry_example>
[Function(nameof(TimerFunction))]
[FixedDelayRetry(5, "00:00:10")]
public static void Run([TimerTrigger("0 */5 * * * *")] TimerInfo timerInfo,
    FunctionContext context)
{
    var logger = context.GetLogger(nameof(TimerFunction));

[FunctionName("TimerTriggerCSharp")]
public static void Run([TimerTrigger("0 */5 * * * *")]TimerInfo myTimer, ILogger log)
{
    if (myTimer.IsPastDue)
    {
        log.LogInformation("Timer is running late!");
    }
    log.LogInformation($"C# Timer trigger function executed at: {DateTime.Now}");
}

@FunctionName("keepAlive")
public void keepAlive(
  @TimerTrigger(name = "keepAliveTrigger", schedule = "0 */5 * * * *") String timerInfo,
      ExecutionContext context
 ) {
     // timeInfo is a JSON string, you can deserialize it to an object using your favorite JSON library
     context.getLogger().info("Timer is triggered: " + timerInfo);
}

import datetime
import logging
import azure.functions as func

app = func.FunctionApp()

@app.function_name(name="mytimer")
@app.timer_trigger(schedule="0 */5 * * * *", 
              arg_name="mytimer",
              run_on_startup=True) 
def test_function(mytimer: func.TimerRequest) -> None:
    utc_timestamp = datetime.datetime.utcnow().replace(
        tzinfo=datetime.timezone.utc).isoformat()
    if mytimer.past_due:
        logging.info('The timer is past due!')
    logging.info('Python timer trigger function ran at %s', utc_timestamp)

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

import datetime
import logging

import azure.functions as func


def main(mytimer: func.TimerRequest) -> None:
    utc_timestamp = datetime.datetime.now(datetime.timezone.utc).isoformat()

    if mytimer.past_due:
        logging.info('The timer is past due!')

    logging.info('Python timer trigger function ran at %s', utc_timestamp)

import { app, InvocationContext, Timer } from '@azure/functions';

export async function timerTrigger1(myTimer: Timer, context: InvocationContext): Promise<void> {
    context.log('Timer function processed request.');
}

app.timer('timerTrigger1', {
    schedule: '0 */5 * * * *',
    handler: timerTrigger1,
});

const { app } = require('@azure/functions');

app.timer('timerTrigger1', {
    schedule: '0 */5 * * * *',
    handler: (myTimer, context) => {
        context.log('Timer function processed request.');
    },
});

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

module.exports = async function (context, myTimer) {
    var timeStamp = new Date().toISOString();

    if (myTimer.isPastDue)
    {
        context.log('Node is running late!');
    }
    context.log('Node timer trigger function ran!', timeStamp);   
};

{
    "schedule": "0 */5 * * * *",
    "name": "myTimer",
    "type": "timerTrigger",
    "direction": "in"
}

# Input bindings are passed in via param block.
param($myTimer)

# Get the current universal time in the default string format.
$currentUTCtime = (Get-Date).ToUniversalTime()

# The 'IsPastDue' property is 'true' when the current function invocation is later than scheduled.
if ($myTimer.IsPastDue) {
    Write-Host "PowerShell timer is running late!"
}

# Write an information log with the current time.
Write-Host "PowerShell timer trigger function ran! TIME: $currentUTCtime"

로컬에서 개발하는 경우 Values 컬렉션의 local.settings.json 파일에 애플리케이션 설정을 추가합니다.

전체 예제는 예제 섹션을 참조하세요.

사용

타이머 트리거 함수가 호출되면 타이머 개체가 함수에 전달됩니다. 다음 JSON은 타이머 개체의 예제 표현입니다.

{
    "Schedule":{
        "AdjustForDST": true
    },
    "ScheduleStatus": {
        "Last":"2016-10-04T10:15:00+00:00",
        "LastUpdated":"2016-10-04T10:16:00+00:00",
        "Next":"2016-10-04T10:20:00+00:00"
    },
    "IsPastDue":false
}

{
    "schedule":{
        "adjustForDST": true
    },
    "scheduleStatus": {
        "last":"2016-10-04T10:15:00+00:00",
        "lastUpdated":"2016-10-04T10:16:00+00:00",
        "next":"2016-10-04T10:20:00+00:00"
    },
    "isPastDue":false
}

현재 함수 호출이 일정보다 늦은 경우 isPastDue 속성은 true입니다. 예를 들어 함수 앱을 다시 시작하면 호출이 누락될 수 있습니다.

NCRONTAB 식

Azure Functions는 NCronTab 라이브러리를 사용하여 CRON 식을 해석합니다. NCRONTAB 식은 CRON 식과 유사합니다. 단, 시간 전체 자릿수(초)에 사용할 시작 부분에 추가 여섯 번째 필드가 포함됩니다.

{second} {minute} {hour} {day} {month} {day-of-week}

각 필드에는 다음과 같은 형식의 값 중 하나가 포함될 수 있습니다.

월 또는 요일을 지정하려면 숫자 값, 이름 또는 이름 약어를 사용할 수 있습니다.

• 요일의 경우 숫자 값은 0에서 6까지이며 0은 Sunday로 시작합니다.
• 이름은 영어입니다. 예: Monday, January.
• 이름은 대/소문자를 구분하지 않습니다.
• 이름은 축약될 수 있습니다. 약어에는 3개 문자를 사용하는 것이 좋습니다. 예: Mon, Jan.

NCRONTAB 예제

다음은 Azure Functions에서 타이머 트리거를 사용할 수 있는 NCRONTAB 식의 몇 가지 예입니다.

NCRONTAB 표준 시간대

NCRONTAB 식의 숫자는 시간 범위가 아닌 시간과 날짜를 나타냅니다. 예를 들어 필드의 hour 5는 5시간마다가 아니라 오전 5:00을 참조합니다.

CRON 식과 함께 사용하는 기본 표준 시간대는 UTC(협정 세계시)입니다. 다른 표준 시간대를 기반으로 하는 CRON 식을 사용하려면 WEBSITE_TIME_ZONE이라는 함수 앱에 대한 앱 설정을 만듭니다.

이 설정의 값은 함수 앱이 실행되는 운영 체제 및 플랜에 따라 다릅니다.

예를 들어 미국 동부 표준시(Eastern Standard Time(Windows) 또는 America/New_York(Linux)로 표시)는 현재 표준 시간 동안 UTC-05:00를 사용하고 일광 절약 시간 동안에는 UTC-04:00를 사용합니다. 매일 오전 10시(미국 동부 표준시)에 타이머 트리거를 두려면 WEBSITE_TIME_ZONE이라는 함수 앱에 대한 앱 설정을 만들고, 값을 Eastern Standard Time(Windows) 또는 America/New_York(Linux)로 설정하고, 다음 NCRONTAB 식을 사용합니다.

"0 0 10 * * *"

WEBSITE_TIME_ZONE을 사용하는 경우 일광 절약 시간 및 표준 시간의 변경을 포함하여 특정 시간대의 시간 변경에 따라 조정됩니다.

TimeSpan

App Service 계획에서 함수 앱을 실행 중인 경우에만 TimeSpan을 사용할 수 있습니다.

NCRONTAB 식과 달리 값은 TimeSpan 각 함수 호출 사이의 시간 간격을 지정합니다. 지정된 간격보다 오래 실행한 후 함수가 완료되면 타이머는 즉시 함수를 다시 호출합니다.

문자열 TimeSpan 로 표현되는 형식은 24보다 작은 경우 hh 입니다hh:mm:ss. 처음 두 자리가 24 이상인 경우 형식은 dd:hh:mm입니다. 다음 몇 가지 예를 참조하세요.

확장

함수 앱이 여러 인스턴스로 확장하는 경우 모든 인스턴스에서 타이머 트리거 함수의 단일 인스턴스만을 실행합니다. 아직 실행 중인 미해결 호출이 있는 경우 다시 트리거되지 않습니다.

스토리지를 공유하는 함수 앱

App Service에 배포되지 않은 함수 앱 간에 스토리지 계정을 공유하는 경우 각 앱에 호스트 ID를 명시적으로 할당해야 할 수 있습니다.

식별 값을 생략하거나 각 함수 앱의 식별 구성을 다른 값으로 수동으로 설정할 수 있습니다.

타이머 트리거는 함수 앱이 여러 인스턴스로 확장되는 경우 스토리지 잠금을 사용하여 하나의 타이머 인스턴스만이 존재하도록 합니다. 두 함수 앱이 동일한 식별 구성을 공유하고 각각 타이머 트리거를 사용하는 경우 하나의 타이머만 실행됩니다.

다시 시도 동작

큐 트리거와 다르게 타이머 트리거는 함수가 실패한 후에 다시 시도하지 않습니다. 함수가 실패하면 일정에 따라 다음 시간까지 다시 호출되지 않습니다.

수동으로 타이머 트리거 호출

Azure Functions에 대한 타이머 트리거는 함수를 수동으로 트리거하기 위해 호출할 수 있는 HTTP 웹후크를 제공합니다. 이는 다음 시나리오에서 매우 유용할 수 있습니다.

• 통합 테스트
• 스모크 테스트 또는 워밍업 활동의 일부로 슬롯 교환
• 데이터베이스에서 캐시 또는 조회 테이블을 즉시 채우는 함수의 초기 배포

타이머 트리거 함수를 수동으로 호출하는 방법에 대한 자세한 내용은 HTTP 트리거가 아닌 함수를 수동으로 실행하는 방법을 참조하세요.

문제 해결

타이머 트리거가 예상대로 작동하지 않을 때 수행할 작업에 대한 자세한 내용은 타이머 트리거 함수가 실행되지 않는 문제를 조사하고 보고하는 방법을 참조하세요.

연결

타이머 트리거는 Azure Functions Core Tools를 통해 로컬로 실행되는 경우를 제외하고 Blob Storage에 대한 암시적 종속성을 갖습니다. 시스템은 Blob Storage를 사용하여 앱이 확장되면 여러 인스턴스에서 조정합니다. 호스트 스토리지(AzureWebJobsStorage) 연결을 사용하여 Blob Storage에 액세스합니다. ID 기반 연결을 사용하도록 호스트 스토리지를 구성하는 경우 ID에는 호스트 스토리지의 기본 요구 사항인 Storage Blob 데이터 소유자 역할이 있어야 합니다.

다음 단계