5 Star 4 Fork 47

OpenHarmony / hiviewdfx_hitrace

Create your Gitee Account
Explore and code with more than 8 million developers,Free private repositories !:)
Sign up
Clone or Download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

HiTrace

Overview

HiTrace provides APIs to implement call chain tracing throughout a service process. With HiTrace, you can quickly obtain the run log for the call chain of a specified service process and locate faults in cross-device, cross-process, or cross-thread communications.

Architecture

Figure 1 Architecture of HiTrace

HiTrace is the lightweight implementation based on the distributed call chain of cloud computing. HiTrace implements call chain tracing as follows:

  • Transfers traceid in cross-device, cross-process, and cross-thread communications.
  • Stores traceid in the thread local storage (TLS) at the Native layer of the process.
  • Automatically adds traceid to existing events and run logs.

Directory Structure

/base/hiviewdfx/hitrace
├── frameworks            # Framework code
│   └── native            # HiTrace Native implementation code
├── interfaces            # APIs
│   └── js                # JS APIs
│       └── kits          # JS inner implementation code 
│   └── native            # C/C++ APIs
│       └── innerkits     # Header files opened to internal subsystems
└── test                  # Test cases

Constraints

HiTrace is already supported by the IPC and EventHandler communication mechanisms. If you are using a custom communication mechanism, adaptation is required to use HiTrace.

Usage

Available APIs

Major APIs of HiTrace

Class

API

Description

HiTrace

HiTraceId begin(String name, int flags)

Starts call chain tracing, generates a HiTraceId object, and sets it in the TLS of the calling thread.

Input parameters:

name: Indicates the name of the service process.

flags: Indicates call chain flags, which can be used in combination.

HITRACE_FLAG_INCLUDE_ASYNC: Traces both synchronous and asynchronous calls. By default, only synchronous calls are traced.

HITRACE_FLAG_DONOT_CREATE_SPAN: Do note create a span. By default, a span is created.

HITRACE_FLAG_TP_INFO: Outputs the tracepoint information. By default, the tracepoint information is not output.

HITRACE_FLAG_NO_BE_INFO: Do not output the start and end information. By default, the information is output.

HITRACE_FLAG_DONOT_ENABLE_LOG: Do not associate logs for output. By default, logs are associated for output.

HITRACE_FLAG_FAULT_TRIGGER: Triggers call chain tracing by fault. By default, call chain tracing is triggered normally.

HITRACE_FLAG_D2D_TP_INFO: Outputs inter-device tracepoint information. By default, the tracepoint information is not output.

HITRACE_FLAG_DEFAULT: Indicates the default flag.

Output parameters: none

Return value: Returns a valid HiTraceId object if call chain tracing is triggered successfully; returns an invalid object otherwise.

Note: In nested tracing mode, an invalid object will be returned if tracing is started at the nested layer.

void end(HiTraceId id)

Stops call chain tracing based on the HiTraceId object returned by the Begin API, and clears the HiTraceId object in the TLS of the calling thread.

Input parameters:

id: Indicates the HiTraceId object.

Output parameters: none

Return value: none

Repositories Involved

DFX SubSystem

hiviewdfx_hiview

hiviewdfx_hilog

hiviewdfx_hiappevent

hiviewdfx_hisysevent

About

A Lightweight Distributed Tracing | 轻量级的分布式调用链跟踪 expand collapse
C++ and 3 more languages
Apache-2.0
Cancel

Releases

No release

OpenHarmony

Contributors

All

Activities

Load More
can not load any more
1
https://git.oschina.net/openharmony/hiviewdfx_hitrace.git
git@git.oschina.net:openharmony/hiviewdfx_hitrace.git
openharmony
hiviewdfx_hitrace
hiviewdfx_hitrace
master

Search