2e1fd5a3c4
* HIP API perfetto args + updated perfetto categories
- Support for HIP API args field in perfetto
- PERFETTO_CATEGORIES -> OMNITRACE_PERFETTO_CATEGORIES
- Changed perfetto categories for several trace events and trace counters
- migrated several TRACE_EVENT_* to use omnitrace::tracing::{push,pop}_perfetto_ts(...)
* Tweaked category_region to encode the type of args as well as value
- Affects MPI args field in perfetto
* Improved testing in ubuntu-focal.yml
- "Test Install" step sources setup-env.sh
- "Test Install" step tests python support
- "Test Install" step tests reading ~/.omnitrace.cfg
- Avoid installing boost and tbb libs when building from submodule
* validate-perfetto-proto.py accepts -m / --categories
* Remove reference from category_region typeids
* Tweak opensuse action name
* Tweak the "Test Install" Step of ubuntu-focal
300 lines
16 KiB
C++
300 lines
16 KiB
C++
// MIT License
|
|
//
|
|
// Copyright (c) 2022 Advanced Micro Devices, Inc. All Rights Reserved.
|
|
//
|
|
// Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
// of this software and associated documentation files (the "Software"), to deal
|
|
// in the Software without restriction, including without limitation the rights
|
|
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
// copies of the Software, and to permit persons to whom the Software is
|
|
// furnished to do so, subject to the following conditions:
|
|
//
|
|
// The above copyright notice and this permission notice shall be included in all
|
|
// copies or substantial portions of the Software.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
// SOFTWARE.
|
|
|
|
#pragma once
|
|
|
|
#include "library/defines.hpp"
|
|
|
|
#include <timemory/api.hpp>
|
|
#include <timemory/api/macros.hpp>
|
|
#include <timemory/components/data_tracker/types.hpp>
|
|
#include <timemory/components/macros.hpp>
|
|
#include <timemory/components/user_bundle/types.hpp>
|
|
#include <timemory/enum.h>
|
|
#include <timemory/mpl/concepts.hpp>
|
|
#include <timemory/mpl/type_traits.hpp>
|
|
|
|
#include <type_traits>
|
|
|
|
TIMEMORY_DEFINE_NS_API(project, omnitrace)
|
|
TIMEMORY_DEFINE_NS_API(category, process_sampling)
|
|
|
|
TIMEMORY_DECLARE_COMPONENT(roctracer)
|
|
|
|
/// \struct tim::trait::name
|
|
/// \brief provides a constexpr string in ::value
|
|
TIMEMORY_DECLARE_TYPE_TRAIT(name, typename Tp)
|
|
|
|
#define TIMEMORY_DEFINE_NAME_TRAIT(NAME, ...) \
|
|
namespace tim \
|
|
{ \
|
|
namespace trait \
|
|
{ \
|
|
template <> \
|
|
struct name<__VA_ARGS__> \
|
|
{ \
|
|
static constexpr auto value = NAME; \
|
|
}; \
|
|
template <> \
|
|
struct name<type_list<__VA_ARGS__>> : name<__VA_ARGS__> \
|
|
{}; \
|
|
} \
|
|
}
|
|
|
|
TIMEMORY_DEFINE_NS_API(category, host)
|
|
TIMEMORY_DEFINE_NS_API(category, user)
|
|
TIMEMORY_DEFINE_NS_API(category, device)
|
|
TIMEMORY_DEFINE_NS_API(category, device_hip)
|
|
TIMEMORY_DEFINE_NS_API(category, device_hsa)
|
|
TIMEMORY_DEFINE_NS_API(category, rocm_hip)
|
|
TIMEMORY_DEFINE_NS_API(category, rocm_hsa)
|
|
TIMEMORY_DEFINE_NS_API(category, rocm_smi)
|
|
TIMEMORY_DEFINE_NS_API(category, kokkos)
|
|
TIMEMORY_DEFINE_NS_API(category, mpi)
|
|
TIMEMORY_DEFINE_NS_API(category, ompt)
|
|
TIMEMORY_DEFINE_NS_API(category, critical_trace)
|
|
TIMEMORY_DEFINE_NS_API(category, host_critical_trace)
|
|
TIMEMORY_DEFINE_NS_API(category, device_critical_trace)
|
|
|
|
TIMEMORY_DEFINE_NAME_TRAIT("host", category::host);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("device", category::device);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("device_hip", category::device_hip);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("device_hsa", category::device_hsa);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("user", category::user);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("rocm_hip", category::rocm_hip);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("rocm_hsa", category::rocm_hsa);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("rocm_smi", category::rocm_smi);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("sampling", category::sampling);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("thread_sampling", category::thread_sampling);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("kokkos", category::kokkos);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("mpi", category::mpi);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("ompt", category::ompt);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("critical-trace", category::critical_trace);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("host-critical-trace", category::host_critical_trace);
|
|
TIMEMORY_DEFINE_NAME_TRAIT("device-critical-trace", category::device_critical_trace);
|
|
|
|
namespace omnitrace
|
|
{
|
|
namespace component
|
|
{
|
|
template <typename... Tp>
|
|
using data_tracker = tim::component::data_tracker<Tp...>;
|
|
|
|
template <typename... Tp>
|
|
using functor_t = std::function<void(Tp...)>;
|
|
|
|
using default_functor_t = functor_t<const char*>;
|
|
|
|
struct omnitrace;
|
|
struct user_region;
|
|
struct backtrace;
|
|
struct backtrace_wall_clock
|
|
{};
|
|
struct backtrace_cpu_clock
|
|
{};
|
|
struct backtrace_fraction
|
|
{};
|
|
struct backtrace_gpu_busy
|
|
{};
|
|
struct backtrace_gpu_temp
|
|
{};
|
|
struct backtrace_gpu_power
|
|
{};
|
|
struct backtrace_gpu_memory
|
|
{};
|
|
using sampling_wall_clock = data_tracker<double, backtrace_wall_clock>;
|
|
using sampling_cpu_clock = data_tracker<double, backtrace_cpu_clock>;
|
|
using sampling_percent = data_tracker<double, backtrace_fraction>;
|
|
using sampling_gpu_busy = data_tracker<double, backtrace_gpu_busy>;
|
|
using sampling_gpu_temp = data_tracker<double, backtrace_gpu_temp>;
|
|
using sampling_gpu_power = data_tracker<double, backtrace_gpu_power>;
|
|
using sampling_gpu_memory = data_tracker<double, backtrace_gpu_memory>;
|
|
using roctracer = tim::component::roctracer;
|
|
|
|
template <typename ApiT, typename StartFuncT = default_functor_t,
|
|
typename StopFuncT = default_functor_t>
|
|
struct functors;
|
|
} // namespace component
|
|
} // namespace omnitrace
|
|
|
|
#if !defined(OMNITRACE_USE_ROCTRACER)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, component::roctracer, false_type)
|
|
#endif
|
|
|
|
#if !defined(TIMEMORY_USE_LIBUNWIND)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::api::sampling, false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::backtrace, false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_wall_clock,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_cpu_clock,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_percent,
|
|
false_type)
|
|
#endif
|
|
|
|
#if !defined(TIMEMORY_USE_LIBUNWIND) || !defined(OMNITRACE_USE_ROCM_SMI)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_gpu_busy,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_gpu_temp,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_gpu_power,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_available, omnitrace::component::sampling_gpu_memory,
|
|
false_type)
|
|
#endif
|
|
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::omnitrace, project::omnitrace,
|
|
category::dynamic_instrumentation, os::supports_linux)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::user_region, project::omnitrace,
|
|
os::supports_linux)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::roctracer, project::omnitrace,
|
|
tpls::rocm, device::gpu, os::supports_linux,
|
|
category::external)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_wall_clock, project::omnitrace,
|
|
category::timing, os::supports_unix, category::sampling,
|
|
category::interrupt_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_cpu_clock, project::omnitrace,
|
|
category::timing, os::supports_unix, category::sampling,
|
|
category::interrupt_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_percent, project::omnitrace,
|
|
category::timing, os::supports_unix, category::sampling,
|
|
category::interrupt_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_gpu_busy, project::omnitrace,
|
|
tpls::rocm, device::gpu, os::supports_linux,
|
|
category::sampling, category::process_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_gpu_memory, project::omnitrace,
|
|
tpls::rocm, device::gpu, os::supports_linux, category::memory,
|
|
category::sampling, category::process_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_gpu_power, project::omnitrace,
|
|
tpls::rocm, device::gpu, os::supports_linux, category::power,
|
|
category::sampling, category::process_sampling)
|
|
TIMEMORY_SET_COMPONENT_API(omnitrace::component::sampling_gpu_temp, project::omnitrace,
|
|
tpls::rocm, device::gpu, os::supports_linux,
|
|
category::temperature, category::sampling,
|
|
category::process_sampling)
|
|
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::omnitrace, OMNITRACE_COMPONENT,
|
|
"omnitrace", "omnitrace_component")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::user_region, OMNITRACE_USER_REGION,
|
|
"user_region", "omnitrace_user_region")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::roctracer, OMNITRACE_ROCTRACER,
|
|
"roctracer", "omnitrace_roctracer")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_wall_clock,
|
|
OMNITRACE_SAMPLING_WALL_CLOCK, "sampling_wall_clock", "")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_cpu_clock,
|
|
OMNITRACE_SAMPLING_CPU_CLOCK, "sampling_cpu_clock", "")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_percent,
|
|
OMNITRACE_SAMPLING_PERCENT, "sampling_percent", "")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_gpu_busy,
|
|
OMNITRACE_SAMPLING_GPU_BUSY, "sampling_gpu_busy",
|
|
"sampling_gpu_util")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_gpu_memory,
|
|
OMNITRACE_SAMPLING_GPU_MEMORY_USAGE,
|
|
"sampling_gpu_memory_usage", "")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_gpu_power,
|
|
OMNITRACE_SAMPLING_GPU_POWER, "sampling_gpu_power", "")
|
|
TIMEMORY_PROPERTY_SPECIALIZATION(omnitrace::component::sampling_gpu_temp,
|
|
OMNITRACE_SAMPLING_GPU_TEMP, "sampling_gpu_temp", "")
|
|
|
|
TIMEMORY_METADATA_SPECIALIZATION(
|
|
omnitrace::component::omnitrace, "omnitrace",
|
|
"Invokes instrumentation functions 'omnitrace_push_trace' and 'omnitrace_pop_trace'",
|
|
"Used by gotcha wrappers")
|
|
TIMEMORY_METADATA_SPECIALIZATION(
|
|
omnitrace::component::user_region, "user_region",
|
|
"Invokes instrumentation functions 'omnitrace_user_push_region' and "
|
|
"'omnitrace_user_pop_region'",
|
|
"Used by OMPT")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::roctracer, "roctracer",
|
|
"High-precision ROCm API and kernel tracing", "")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_wall_clock,
|
|
"sampling_wall_clock", "Wall-clock timing",
|
|
"Derived from statistical sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_cpu_clock,
|
|
"sampling_cpu_clock", "CPU-clock timing",
|
|
"Derived from statistical sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_percent,
|
|
"sampling_percent",
|
|
"Fraction of wall-clock time spent in functions",
|
|
"Derived from statistical sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_gpu_busy,
|
|
"sampling_gpu_busy",
|
|
"GPU Utilization (% busy) via ROCm-SMI",
|
|
"Derived from sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_gpu_memory,
|
|
"sampling_gpu_memory_usage",
|
|
"GPU Memory Usage via ROCm-SMI", "Derived from sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_gpu_power,
|
|
"sampling_gpu_power", "GPU Power Usage via ROCm-SMI",
|
|
"Derived from sampling")
|
|
TIMEMORY_METADATA_SPECIALIZATION(omnitrace::component::sampling_gpu_temp,
|
|
"sampling_gpu_temp", "GPU Temperature via ROCm-SMI",
|
|
"Derived from sampling")
|
|
|
|
// statistics type
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_wall_clock, double)
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_cpu_clock, double)
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_gpu_busy, double)
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_gpu_temp, double)
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_gpu_power, double)
|
|
TIMEMORY_STATISTICS_TYPE(omnitrace::component::sampling_gpu_memory, double)
|
|
|
|
// enable timing units
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_timing_category,
|
|
omnitrace::component::sampling_wall_clock, true_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_timing_category,
|
|
omnitrace::component::sampling_cpu_clock, true_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_timing_category, omnitrace::component::sampling_percent,
|
|
true_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(uses_timing_units,
|
|
omnitrace::component::sampling_wall_clock, true_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(uses_timing_units,
|
|
omnitrace::component::sampling_cpu_clock, true_type)
|
|
|
|
// enable percent units
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(uses_percent_units,
|
|
omnitrace::component::sampling_gpu_busy, true_type)
|
|
|
|
// enable memory units
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(is_memory_category,
|
|
omnitrace::component::sampling_gpu_memory, true_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(uses_memory_units,
|
|
omnitrace::component::sampling_gpu_memory, true_type)
|
|
|
|
// reporting categories (sum)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_sum, omnitrace::component::sampling_gpu_busy,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_sum, omnitrace::component::sampling_gpu_temp,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_sum, omnitrace::component::sampling_gpu_power,
|
|
false_type)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_sum, omnitrace::component::sampling_gpu_memory,
|
|
false_type)
|
|
|
|
// reporting categories (mean)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_mean, omnitrace::component::sampling_percent,
|
|
false_type)
|
|
|
|
// reporting categories (stats)
|
|
TIMEMORY_DEFINE_CONCRETE_TRAIT(report_statistics, omnitrace::component::sampling_percent,
|
|
false_type)
|