void one()
{
std::this_thread::sleep_for(std::chrono::milliseconds(10));
}
void two()
{
std::this_thread::sleep_for(std::chrono::milliseconds(5));
}
int main()
{
printf("Start\n");
for (int i = 0; i < 10; ++i)
{
one();
two();
}
printf("Finish\n");
}
```
Чтобы включить инструментирование с помощью XRay, нужно добавить несколько флагов, например:
```bash theme={null}
clang++ -o test test.cpp -fxray-instrument -fxray-instruction-threshold=1
```
* `-fxray-instrument` нужен, чтобы инструментировать код.
* `-fxray-instruction-threshold=1` используется, чтобы инструментировать все функции, даже если они
очень маленькие, как в нашем примере. По умолчанию инструментируются функции, содержащие [не менее 200
инструкций](https://llvm.org/docs/XRay.html#instrumenting-your-c-c-objective-c-application).
Проверить, что код был инструментирован правильно, можно по появлению нового раздела в
бинарном файле:
```bash theme={null}
objdump -h -j xray_instr_map test
test: file format elf64-x86-64
Sections:
Idx Name Size VMA LMA File off Algn
17 xray_instr_map 000005c0 000000000002f91c 000000000002f91c 0002f91c 2**0
CONTENTS, ALLOC, LOAD, READONLY, DATA
```
### Запустите процесс с корректными значениями переменных окружения, чтобы собрать трассировку
По умолчанию сбор данных профилирования не выполняется, если он не запрошен явно. Иными словами,
если профилирование не включено, накладные расходы пренебрежимо малы. Можно задать разные значения `XRAY_OPTIONS`, чтобы
настроить, когда профилировщик начинает сбор данных и как именно он это делает.
```bash theme={null}
XRAY_OPTIONS="patch_premain=true xray_mode=xray-basic verbosity=1" ./test
==74394==XRay: Log file in 'xray-log.test.14imlN'
Start
Finish
==74394==Cleaned up log for TID: 74394
```
### Преобразование трассировки
Трассировки XRay можно преобразовать в несколько форматов. Формат `trace_event` очень полезен, потому что
его легко разобрать, и уже есть ряд инструментов, которые его поддерживают, поэтому мы будем использовать именно его:
```bash theme={null}
llvm-xray convert --symbolize --instr_map=./test --output-format=trace_event xray-log.test.14imlN | gzip > test-trace.txt.gz
```
### Визуализируйте трассировку
Можно использовать веб-интерфейсы, такие как [speedscope.app](https://www.speedscope.app/) или
[Perfetto](https://ui.perfetto.dev).
Хотя Perfetto упрощает визуализацию нескольких потоков и выполнение запросов к данным, speedscope лучше
подходит для построения флеймграфа и представления данных в режиме «сэндвич».
#### Хронологический порядок
#### Перекос влево
#### Сэндвич
## Ознакомьтесь с документацией
* [SYSTEM INSTRUMENT](/docs/ru/reference/statements/system#instrument) — Добавьте
или удалите точки инструментирования.
* [system.instrumentation](/docs/ru/reference/system-tables/instrumentation)
— Просматривайте инструментированные точки.
* [system.symbols](/docs/ru/reference/system-tables/symbols) — Просматривайте
символы, чтобы добавлять точки инструментирования.
* [system.trace\_log](/docs/ru/reference/system-tables/trace_log) — Просматривайте данные,
собранные с помощью точек инструментирования.
* [XRay Instrumentation](https://llvm.org/docs/XRay.html)
* Документация [Debugging with XRay](https://llvm.org/docs/XRayExample.html) с дополнительными сведениями.