blob: 41e412aa3010779d69d21fd31f60a5caed80d7a6 [file] [log] [blame]
# Copyright (C) 2022 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Contains tables for tracks."""
from python.generators.trace_processor_table.public import Column as C
from python.generators.trace_processor_table.public import ColumnDoc
from python.generators.trace_processor_table.public import ColumnFlag
from python.generators.trace_processor_table.public import CppInt32
from python.generators.trace_processor_table.public import CppInt64
from python.generators.trace_processor_table.public import CppOptional
from python.generators.trace_processor_table.public import CppSelfTableId
from python.generators.trace_processor_table.public import CppString
from python.generators.trace_processor_table.public import CppTableId
from python.generators.trace_processor_table.public import CppUint32
from python.generators.trace_processor_table.public import Table
from python.generators.trace_processor_table.public import TableDoc
from python.generators.trace_processor_table.public import WrappingSqlView
from src.trace_processor.tables.metadata_tables import CPU_TABLE, MACHINE_TABLE
TRACK_TABLE = Table(
python_module=__file__,
class_name="TrackTable",
sql_name="__intrinsic_track",
columns=[
C("name", CppString()),
C("parent_id", CppOptional(CppSelfTableId())),
C("source_arg_set_id", CppOptional(CppUint32())),
C('machine_id', CppOptional(CppTableId(MACHINE_TABLE))),
C("classification", CppString()),
C("dimension_arg_set_id", CppOptional(CppUint32())),
],
wrapping_sql_view=WrappingSqlView('track'),
tabledoc=TableDoc(
doc='''
Tracks are a fundamental concept in trace processor and represent a
"timeline" for events of the same type and with the same context. See
https://perfetto.dev/docs/analysis/trace-processor#tracks for a more
detailed explanation, with examples.
''',
group='Tracks',
columns={
'name':
'''
Name of the track; can be null for some types of tracks (e.g.
thread tracks).
''',
'parent_id':
'''
The track which is the "parent" of this track. Only non-null
for tracks created using Perfetto's track_event API.
''',
'machine_id':
'''
Machine identifier, non-null for tracks on a remote machine.
''',
'classification':
'''
Classification of this track. Responsible for grouping
similar tracks together.
''',
'dimension_arg_set_id':
ColumnDoc(
doc='''
The dimensions of the track which uniquely identify the
track within a given classification.
Join with the `args` table or use the `EXTRACT_ARG` helper
function to expand the args.
''',
joinable='args.arg_set_id'),
'source_arg_set_id':
ColumnDoc(
doc='''
Generic key-value pairs containing extra information about
the track.
Join with the `args` table or use the `EXTRACT_ARG` helper
function to expand the args.
''',
joinable='args.arg_set_id'),
}))
PROCESS_TRACK_TABLE = Table(
python_module=__file__,
class_name="ProcessTrackTable",
sql_name="process_track",
columns=[
C("upid", CppUint32()),
],
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='''
Tracks which are associated to the process given by the |upid| column
''',
group='Tracks',
columns={
'upid':
ColumnDoc(
doc='The process associated with this track.',
joinable='process.upid'),
}))
THREAD_TRACK_TABLE = Table(
python_module=__file__,
class_name='ThreadTrackTable',
sql_name='thread_track',
columns=[
C('utid', CppUint32()),
],
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='''
Tracks which are associated to the thread given by the |utid| column
''',
group='Tracks',
columns={
'utid':
ColumnDoc(
doc='The thread associated with this track',
joinable='thread.utid',
)
}))
CPU_TRACK_TABLE = Table(
python_module=__file__,
class_name='CpuTrackTable',
sql_name='__intrinsic_cpu_track',
columns=[
C('ucpu', CppTableId(CPU_TABLE)),
],
wrapping_sql_view=WrappingSqlView('cpu_track'),
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks which are associated to a single CPU',
group='Tracks',
columns={
'ucpu': 'The unique CPU identifier associated with this track.',
}))
GPU_TRACK_TABLE = Table(
python_module=__file__,
class_name='GpuTrackTable',
sql_name='gpu_track',
columns=[
C('scope', CppString()),
C('description', CppString()),
C('context_id', CppOptional(CppInt64())),
],
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks associated to a GPU.',
group='Tracks',
columns={
'scope':
'The scope for the track. For debugging purposes only.',
'description':
'The description of the track. For debugging purposes only.',
'context_id':
'The context id for the GPU this track is associated to.'
}))
UID_TRACK_TABLE = Table(
python_module=__file__,
class_name='UidTrackTable',
sql_name='uid_track',
columns=[
C('uid', CppInt32()),
],
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks associated to a UID.',
group='Tracks',
columns={
'uid': 'The uid associated with this track.',
}))
GPU_WORK_PERIOD_TRACK_TABLE = Table(
python_module=__file__,
class_name='GpuWorkPeriodTrackTable',
sql_name='gpu_work_period_track',
columns=[
C('gpu_id', CppUint32()),
],
parent=UID_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing gpu_work_period events.',
group='Tracks',
columns={
'gpu_id': 'The identifier for the GPU.',
}))
COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='CounterTrackTable',
sql_name='counter_track',
columns=[
C('unit', CppString()),
C('description', CppString()),
],
parent=TRACK_TABLE,
tabledoc=TableDoc(
doc='''
Tracks containing counter-like events. See
https://perfetto.dev/docs/analysis/trace-processor#events for a
defintion and examples of counters.
''',
group='Tracks',
columns={
'unit':
'The units of the counter. This column is rarely filled.',
'description':
'The description for this track. For debugging purposes only.'
}))
THREAD_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='ThreadCounterTrackTable',
sql_name='thread_counter_track',
columns=[
C('utid', CppUint32()),
],
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing counter-like events associated to a thread.',
group='Counter Tracks',
columns={
'utid':
ColumnDoc(
doc='The thread associated with this track',
joinable='thread.utid',
)
}))
PROCESS_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='ProcessCounterTrackTable',
sql_name='process_counter_track',
columns=[
C('upid', CppUint32()),
],
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='''
Tracks containing counter-like events associated to a process.
''',
group='Counter Tracks',
columns={
'upid':
ColumnDoc(
doc='The process associated with this track',
joinable='process.upid')
}))
CPU_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='CpuCounterTrackTable',
sql_name='__intrinsic_cpu_counter_track',
columns=[
C('ucpu', CppTableId(CPU_TABLE)),
],
wrapping_sql_view=WrappingSqlView('cpu_counter_track'),
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing counter-like events associated to a CPU.',
group='Counter Tracks',
columns={
'ucpu': 'The unique CPU identifier associated with this track.'
}))
IRQ_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='IrqCounterTrackTable',
sql_name='irq_counter_track',
columns=[
C('irq', CppInt32()),
],
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing counter-like events associated to an hardirq',
group='Counter Tracks',
columns={'irq': 'The identifier for the hardirq.'}))
SOFTIRQ_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='SoftirqCounterTrackTable',
sql_name='softirq_counter_track',
columns=[
C('softirq', CppInt32()),
],
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing counter-like events associated to a softirq',
group='Counter Tracks',
columns={'softirq': 'The identifier for the softirq.'}))
GPU_COUNTER_TRACK_TABLE = Table(
python_module=__file__,
class_name='GpuCounterTrackTable',
sql_name='gpu_counter_track',
columns=[
C('gpu_id', CppUint32()),
],
parent=COUNTER_TRACK_TABLE,
tabledoc=TableDoc(
doc='Tracks containing counter-like events associated to a GPU',
group='Counter Tracks',
columns={'gpu_id': 'The identifier for the GPU.'}))
# Keep this list sorted.
ALL_TABLES = [
COUNTER_TRACK_TABLE,
CPU_COUNTER_TRACK_TABLE,
CPU_TRACK_TABLE,
GPU_COUNTER_TRACK_TABLE,
GPU_TRACK_TABLE,
GPU_WORK_PERIOD_TRACK_TABLE,
IRQ_COUNTER_TRACK_TABLE,
PROCESS_COUNTER_TRACK_TABLE,
PROCESS_TRACK_TABLE,
SOFTIRQ_COUNTER_TRACK_TABLE,
THREAD_COUNTER_TRACK_TABLE,
THREAD_TRACK_TABLE,
TRACK_TABLE,
UID_TRACK_TABLE,
]