다음을 통해 공유


Activity 클래스

정의

로깅에 사용되는 컨텍스트를 통해 작업을 표시합니다.

public ref class Activity : IDisposable
public ref class Activity
public class Activity : IDisposable
public class Activity
type Activity = class
    interface IDisposable
type Activity = class
Public Class Activity
Implements IDisposable
Public Class Activity
상속
Activity
구현

설명

Activity 에는 작업 이름, ID, 시작 시간 및 기간, 태그 및 수하물이 있습니다.

정적 Activity.Current 속성을 사용하여 현재 활동에 액세스할 수 있습니다.

필요한 경우 생성자를 호출하여 활동을 만든 다음, 활동에 대한 부모-자식 관계를 유지하고 를 설정하는 Activity.Current메서드로 Start 시작해야 합니다.

작업이 완료되면 메서드를 사용하여 작업을 중지 Activity.Stop() 해야 합니다.

그러나 개체를 삭제하면 개체를 Activity 중지하므로 를 명시적으로 호출 Activity.Stop()할 필요가 없습니다. 그러면 코딩 패턴이 단순해집니다. 자세한 내용은 Dispose 메서드를 참조하세요.

잘못된 입력에 대한 응답으로 예외를 이스케이프할 수 있는 메서드는 없습니다 Activity . throw되고 catch되지만(디버거와 모니터가 오류를 볼 수 있음) 예외가 표시되지 않고 작업이 적절한 작업을 수행합니다(일반적으로 아무 작업도 수행하지 않음).

생성자

Activity(String)

Activity 클래스의 새 인스턴스를 초기화합니다.

속성

ActivityTraceFlags

활동과 연결된 플래그(W3C ID 사양에 의해 정의됨)를 가져오거나 설정합니다.

Baggage

Activity의 자식 항목으로 전달되는 정보를 나타내는 키/값 쌍의 컬렉션을 가져옵니다.

Context

활동의 컨텍스트를 가져옵니다. 컨텍스트는 활동이 시작된 경우에만 유효합니다.

Current

현재 스레드에 대한 현재 작업(Activity)을 가져오거나 설정합니다. 이는 비동기 호출 간에 이동합니다.

DefaultIdFormat

Activity에 대한 기본 ID 형식을 가져오거나 설정합니다.

DisplayName

활동의 표시 이름을 가져오거나 설정합니다.

Duration

작업 기간을 가져옵니다.

Events

이 활동에 연결된 모든 활동 이벤트 목록을 가져옵니다.

ForceDefaultIdFormat

DefaultIdFormat이 항상 기본 ID 형식을 정의하는 데 사용되는지 여부를 확인하는 값을 가져오거나 설정합니다.

HasRemoteParent

부모 컨텍스트가 원격 전파에서 만들어졌는지 여부를 나타내는 값을 가져옵니다.

Id

특정 요청과 관련된 식별자를 가져옵니다.

IdFormat

Id에 대한 형식을 가져옵니다.

IsAllDataRequested

이 활동을 모든 전파 정보뿐만 아니라 링크, 태그 및 이벤트와 같은 다른 모든 속성으로 채워야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

IsStopped

Activity 개체가 중지되었는지 여부를 나타내는 값을 가져옵니다.

Kind

추적의 활동, 부모 및 자식 간의 관계를 가져옵니다.

Links

이 활동에 연결된 모든 활동 링크 목록을 가져옵니다.

OperationName

작업 이름을 가져옵니다.

Parent

이 작업을 생성한 부모 Activity를 가져옵니다.

ParentId

이 작업의 부모 ID를 가져옵니다.

ParentSpanId

부모의 SpanId를 가져옵니다.

Recorded

W3CIdFlags.Recorded 플래그가 설정되어 있는지 여부를 나타내는 값을 가져옵니다.

RootId

Activity의 루트 ID를 가져옵니다.

Source

이 활동과 연결된 활동 원본을 가져옵니다.

SpanId

Id의 SPAN 부분을 가져옵니다.

StartTimeUtc

작업이 시작된 시간을 가져옵니다.

Status

현재 활동 개체의 상태 코드를 가져옵니다.

StatusDescription

현재 활동 개체의 상태 설명을 가져옵니다.

TagObjects

활동과 함께 기록할 정보를 나타내는 태그 목록을 가져옵니다. 이 정보는 이 활동의 자식으로 전달되지 않습니다.

Tags

로깅 시스템에 Activity와 함께 기록될 정보를 나타내는 키/값 쌍의 컬렉션을 가져옵니다.

TraceId

Id의 TraceId 부분을 가져옵니다.

TraceIdGenerator

부모 컨텍스트가 없는 활동을 시작할 때 추적 ID는 난수를 사용하여 자동으로 생성됩니다. TraceIdGenerator를 사용하여 런타임의 기본 추적 ID 생성 알고리즘을 재정의할 수 있습니다.

TraceStateString

W3C tracestate 헤더를 가져오거나 설정합니다.

메서드

AddBaggage(String, String)

지정된 키와 값으로 새 수하물 항목을 가져오도록 Activity를 업데이트합니다.

AddEvent(ActivityEvent)

지정된 활동 이벤트를 이벤트 목록에 추가합니다.

AddException(Exception, TagList, DateTimeOffset)

로깅에 사용되는 컨텍스트를 통해 작업을 표시합니다.

AddLink(ActivityLink)

로깅에 사용되는 컨텍스트를 통해 작업을 표시합니다.

AddTag(String, Object)

추가 keyvalue를 사용하여 태그를 포함하도록 활동을 업데이트합니다.

AddTag(String, String)

제공된 keyvalue를 사용하여 새 태그를 갖도록 Activity를 업데이트합니다.

Dispose()

활동이 이미 시작된 경우 활동을 중지하고 이벤트 수신기에게 알립니다. 그렇지 않으면 아무 작업도 수행되지 않습니다.

Dispose(Boolean)

파생 형식에 의해 재정의되는 경우 이 메서드는 할당된 리소스를 해제합니다.

EnumerateEvents()

이 Activity 개체에 ActivityEvent 연결된 개체를 열거합니다.

EnumerateLinks()

이 Activity 개체에 ActivityLink 연결된 개체를 열거합니다.

EnumerateTagObjects()

이 Activity 개체에 연결된 태그를 열거합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetBaggageItem(String)

AddBaggage(String, String)을 사용하여 작업에 추가된 키-값 쌍의 값을 반환합니다.

GetCustomProperty(String)

지정된 속성 이름에 매핑되는 개체를 반환합니다.

GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetTagItem(String)

입력 키에 매핑된 활동 태그의 값을 반환합니다. 해당 키가 없으면 를 반환 null 합니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
SetBaggage(String, String)

활동 수하물을 입력 키와 값으로 추가하거나 업데이트합니다. 입력 값이 null 인 경우 - 컬렉션에 동일한 키가 있는 수하물이 있는 경우 이 수하물은 컬렉션에서 제거됩니다. - 그렇지 않으면 아무 일도 발생하지 않으며 컬렉션은 변경되지 않습니다. 입력 값이 아닌 null 경우 - 컬렉션에 동일한 키가 있는 수하물이 있는 경우 이 키에 매핑된 값이 새 입력 값으로 업데이트됩니다. - 그렇지 않으면 키와 값이 컬렉션에 새 수하물로 추가됩니다. 수하물 품목은 원래 현재 활동에 추가된 경우에만 업데이트/제거됩니다. 부모로부터 상속된 항목은 변경/제거되지 않으며, 대신 새 항목이 현재 활동 수하물에 추가됩니다.

SetCustomProperty(String, Object)

이 활동에 사용자 지정 개체를 연결합니다. 지정된 propertyName이 이전에 다른 개체와 연결된 경우 이 속성은 대신 새 propertyValue와 연결되도록 업데이트됩니다. 동일한 값을 사용하는 사용자와의 충돌을 방지하기 위해 고유한 속성 이름을 사용하는 것이 좋습니다.

SetEndTime(DateTime)

해당 DurationStartTimeUtc와 지정된 중지 시간 간의 차이로 설정하도록 Activity를 업데이트합니다.

SetIdFormat(ActivityIdFormat)

시작하기 전에 이 Activity의 ID 형식을 설정합니다.

SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)

TraceId 및 SpanId의 W3C 규칙을 사용하여 부모 ID를 설정합니다.

SetParentId(String)

Activity를 업데이트하여 ID가 parentIdActivity가 이 Activity의 원인임을 나타냅니다.

SetStartTime(DateTime)

Activity의 시작 시간을 설정합니다.

SetStatus(ActivityStatusCode, String)

현재 활동 개체에 대한 상태 코드 및 설명을 설정합니다.

SetTag(String, Object)

입력 키 및 값을 사용하여 활동 태그를 추가하거나 업데이트합니다.

Start()

작업을 시작합니다.

Stop()

작업을 중지합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

이벤트

CurrentChanged

Current 값이 변경될 때 발생합니다.

적용 대상