- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- Administrator's Guide
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
",t};e.buildCustomizationMenuUi=t;function n(e){let t='
",t}function s(e){let n=e.filter.currentValue||e.filter.defaultValue,t='${e.filter.label}
`,e.filter.options.forEach(s=>{let o=s.id===n;t+=``}),t+="${e.filter.label}
`,t+=`Span metadata is composed of attributes and tags.
Span attributes are the content of the span, collected with automatic or manual instrumentation in the application
Span tags are enrichments of context related to the span, for instance host or container tags describing the infrastructure the service is running on.
You can query spans by any span tag and attribute from the trace explorer.
Reserved attributes are a subset of span attributes that are present on every span. These attributes are queryable without prepending the @
character. The full list of reserved attributes is: env
, service
, operation_name
, resource_name
, status
, ingestion_reason
, trace_id
. Refer to the APM terms and concepts for a full definition of these terms.
Span attributes are the content of your span. These are collected out-of-the-box in tracing libraries using automatic instrumentation, manually using custom instrumentation, or remapped in the Datadog backend based on source attributes (see peer attributes, remapped from some source attributes). To search on a specific span attribute, you must prepend an @
character at the beginning of the attribute key.
For instance, to find spans representing calls to a users
table from a postgres database, use the following query: @peer.db.name:users @peer.db.system:postgres
.
Span tags are context around your span, enriched based on the host or the container the service the span is emitted from is running on. You don’t need to prepend an @
character to query for span tags.
You can create facets on top of span tags and attributes to map an attribute to the right type (for example, string or int) and for these attributes to show up in the facet list.
Note: Creating facets is not required for searching spans, generating metrics from spans, or indexing spans with retention filters.
Use qualitative facets when you need to:
datacenter
span tag to scope down the investigation to one specific region when slow requests are detected.usr.email
to see how many distinct users experience errors while loading a specific resource.Note: Although facets are not required for filtering on tags, defining facets for tags that you often use during investigations can help reduce your time to resolution.
Use measures when you need to:
Measures have either a (long) integer or double value, for equivalent capabilities.
Measures support units (time in seconds or size in bytes) for handling of orders of magnitude at query time and display time. The unit is a property of the measure itself, not of the field.
For example, consider a duration
measure in nanoseconds. Suppose spans from service:A
have duration:1000
, meaning 1000 milliseconds
. Supposed spans from service:B
have duration:500
, meaning 500 microseconds
. Use duration:>20ms
to consistently query span tags from both services at once. Read query syntax for more reference information about queries.
The search bar provides the most comprehensive set of interactions to filter and group your data. However, for many cases, the facet panel is a straightforward way to navigate into your data. Open a facet to see a summary of its content for the scope of the current query.
The search bar and URL automatically reflect your selections from the facet panel.
Your organization has many facets to address use cases across the various teams that use traces. Most likely, only a subset of these facets is valuable to you in a specific troubleshooting context.
Hide facets that you don’t need on a routine basis, to keep only the most relevant facets for your troubleshooting sessions.
Hidden facets are still visible in the facet search (see the Filter Facet section) in case you need it. Unhide hidden facets from facet search.
Hiding facets is specific to your own troubleshooting context and does not impact your teammates’ view, unless you update a saved view. Hidden facets is part of the context saved in a saved view.
Facets are grouped into meaningful themes in the facet list. Assigning or reassigning a group for a facet affects only the facet list, and has no impact on search or analytics.
Use the search facets box on the facet panel to scope the whole facet list and navigate more quickly to the one facet you need to interact with. Search facets uses the facet display name and field name to scope results.
Creating a facet on a span attribute/tag is not a mandatory step to search for spans. Facets are useful if you wish to add a meaningful description to a specific span attribute, or if you want the span attribute values to appear on the Facet list on the left-hand side of the span list.
The easiest way to create a facet is to add it from the trace side panel so that most of the facet details (such as the field path and underlying type) are pre-filled. In the Trace Explorer, navigate to a span of interest that contains the field to create a facet on. Open the trace side-panel for this span by selecting the span from the list. Click on the desired field (either in span tags or in infrastructure tags) and create a facet from there:
If finding a span that has the desired field is not an option, create a facet directly from the facet panel by clicking + Add.
Define the underlying field (key) name for this facet:
@
prefix.Autocomplete based on the content in spans of the current views helps you to define the proper field name. But you can use virtually any value here, specifically in the case that you don’t yet have matching spans received by Datadog.
추가 유용한 문서, 링크 및 기사: