다음을 통해 공유

RoleInstanceDiagnosticManager.BeginOnDemandTransfer 메서드 (DataBufferName, OnDemandTransferOptions)

  • 아티클

업데이트 날짜: 2013년 11월

지정된 옵션을 사용하여 지정된 데이터 버퍼의 주문형 전송을 시작합니다.

네임스페이스: Microsoft.WindowsAzure.Diagnostics.Management
어셈블리: Microsoft.WindowsAzure.Diagnostics.dll의 Microsoft.WindowsAzure.Diagnostics

구문

‘선언
Public Function BeginOnDemandTransfer ( _
    sourceBufferName As DataBufferName, _
    onDemandTransferOptions As OnDemandTransferOptions _
) As Guid

public Guid BeginOnDemandTransfer (
    DataBufferName sourceBufferName,
    OnDemandTransferOptions onDemandTransferOptions
)

public:
Guid BeginOnDemandTransfer (
    DataBufferName sourceBufferName, 
    OnDemandTransferOptions^ onDemandTransferOptions
)

매개 변수

반환 값

종류: System.Guid

전송을 식별하는 요청 ID입니다.

설명

BeginOnDemandTransfer(DataBufferName,OnDemandTransferOptions) 메서드는 역할 인스턴스의 로컬 저장소에서 저장소 계정으로 버퍼링된 진단 데이터의 주문형 전송을 시작하는 데 사용합니다.

입력 매개 변수, sourceBufferName은 전송하려는 DataBufferName 열거의 값을 나타냅니다. 두 번째 입력 매개 변수인 onDemandTransferOptions는 주문형 전송을 위한 구성 옵션을 포함하는 OnDemandTransferOptions 개체입니다.

역할의 각 인스턴스에 대한 각 데이터 버퍼 전송은 한 번에 하나씩만 큐에 넣을 수 있습니다. 여러 전송을 큐에 둘 수 없습니다. 특정 데이터 버퍼의 새 전송을 큐에 두려면 먼저 EndOnDemandTransfer 메서드 또는 CancelOnDemandTransfers 메서드를 호출하여 현재 전송을 취소해야 합니다.

NotificationQueueName 값을 지정한 경우 큐에 완료 알림을 보냅니다.

Example

다음 코드 조각에서는 역할 인스턴스에 대한 Windows 이벤트 로그의 주문형 전송을 시작합니다.

// Get the diagnostic monitor for the specified role instance.
RoleInstanceDiagnosticManager roleInstanceDiagnosticManager = 
         new RoleInstanceDiagnosticManager(myStorageAccount, 
                                           "28281fc7754b44faa9ccf4911983edf1",
                                           "MyWebRole",
                                           "deployment(1).MyAzureProject.WebRole1.0");

// Specify the on-demand transfer options for the diagnostic data.
OnDemandTransferOptions transferOptions = new OnDemandTransferOptions();

// Get data starting from an hour ago until now.
transferOptions.From = DateTime.UtcNow.AddHours(1.0);
transferOptions.To = DateTime.UtcNow;
            
// Specify only error-level logs.
transferOptions.LogLevelFilter = LogLevel.Error;

// Provide a name for the queue where completion messages will be stored.
transferOptions.NotificationQueueName = "wad-on-demand-transfers";

// Start a transfer of Windows event logs.
roleInstanceDiagnosticManager.BeginOnDemandTransfer(DataBufferName.WindowsEventLogs, transferOptions);

경고

이 API는 Azure SDK 버전 2.5 이상에서 지원되지 않습니다. 대신 diagnostics.wadcfg XML 구성 파일을 사용하세요. 자세한 내용은 Collect Logging Data by Using Azure Diagnostics를 참조하세요.

스레드 보안

이 유형의 public static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

플랫폼

개발 플랫폼

Windows Vista, Windows 7 및 Windows Server 2008

대상 플랫폼

Change History

참고 항목

참조

RoleInstanceDiagnosticManager 클래스
RoleInstanceDiagnosticManager 멤버
Microsoft.WindowsAzure.Diagnostics.Management 네임스페이스