Callback tracing for kernel dispatches + External correlation ID request service (#682)

* Support ROCPROFILER_CALLBACK_TRACING_KERNEL_DISPATCH

* Fix doxygen

* Update callback tracing

- temporary hacks for kind operation name and iterate kind operations

* Update source/include/rocprofiler-sdk

- introduce sequence id for kernel dispatches

* Update lib/rocprofiler-sdk (seq id)

- support sequence id passing

* Update tests (seq id)

- testing for sequence ids

* Cleanup include/rocprofiler-sdk/fwd.h

* Misc cleanup

* External Correlation ID Request Service (#699)

* External correlation ID request service

- callback requesting an external correlation ID instead of fetching from top of pushed external correlation ID stack

* Update external correlation id request support

- pass internal correlation ID in callback
- async copy generates a correlation ID if none already exists
- added external correlation ID request support for scratch memory tracing
- updated scratch memory tracing to use tracing:: functions

* Update hsa/queue.hpp

- new line at EOF

* Misc tweaks

- remove unnecessary logging in agent.cpp
- correlation_id::add_ref_count check for retirement
- finalization check in HSA queue AsyncSignalHandler

* Improve assertion failure logging in misc tests

* Update include/rocprofiler-sdk/fwd.h

- remove rocprofiler_record_counter_header_t

* Move lib/rocprofiler-sdk/tracing.hpp into lib/rocprofiler-sdk/tracing/ folder

* Update lib/rocprofiler-sdk/hsa/*

- hsa::get_hsa_status_string
- queue_info_session.hpp header
- rocprofiler_packet.hpp

* Update lib/rocprofiler-sdk/{counters,hip,marker}

- execute_phase_exit_callbacks tweaks
- queue_info_session tweaks

* Move rocprofiler_kernel_dispatch_operation_t to include/rocprofiler-sdk/fwd.h

* Update rocprofiler_buffer_tracing_kernel_dispatch_record_t

- add operation field and thread_id field

* Add lib/rocprofiler-sdk/kernel_dispatch

- enum <-> string mapping for kernel dispatch
- tracing implementations

* Update lib/rocprofiler-sdk/CMakeLists.txt

- tracing and kernel dispatch sub-directories

* Update lib/rocprofiler-sdk/{buffer,callback}_tracing.cpp

- invoke rocprofiler::kernel_tracing functions

* Update tests/common/serialization.hpp

- support operation and thread_id fields for rocprofiler_buffer_tracing_kernel_dispatch_record_t

* Update tests/tools/json-tool.cpp

- use external correlation id request service

* Rename sequence_id to dispatch_id

source/lib/rocprofiler-sdk/marker/marker.def.cpp

@@ -23,6 +23,7 @@
 #include "lib/rocprofiler-sdk/marker/defines.hpp"
 #include "lib/rocprofiler-sdk/marker/marker.hpp"
 
+#include <rocprofiler-sdk/external_correlation.h>
 #include <rocprofiler-sdk/marker/table_id.h>
 
 namespace rocprofiler
@@ -42,33 +43,39 @@ template <>
 struct roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_RoctxCore>
 : roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_LAST>
 {
+    using enum_type                           = rocprofiler_marker_core_api_id_t;
     static constexpr auto callback_domain_idx = ROCPROFILER_CALLBACK_TRACING_MARKER_CORE_API;
     static constexpr auto buffered_domain_idx = ROCPROFILER_BUFFER_TRACING_MARKER_CORE_API;
     static constexpr auto none                = ROCPROFILER_MARKER_CORE_API_ID_NONE;
     static constexpr auto last                = ROCPROFILER_MARKER_CORE_API_ID_LAST;
-    using enum_type                           = rocprofiler_marker_core_api_id_t;
+    static constexpr auto external_correlation_id_domain_idx =
+        ROCPROFILER_EXTERNAL_CORRELATION_REQUEST_MARKER_CORE_API;
 };
 
 template <>
 struct roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_RoctxControl>
 : roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_LAST>
 {
+    using enum_type                           = rocprofiler_marker_control_api_id_t;
     static constexpr auto callback_domain_idx = ROCPROFILER_CALLBACK_TRACING_MARKER_CONTROL_API;
     static constexpr auto buffered_domain_idx = ROCPROFILER_BUFFER_TRACING_MARKER_CONTROL_API;
     static constexpr auto none                = ROCPROFILER_MARKER_CONTROL_API_ID_NONE;
     static constexpr auto last                = ROCPROFILER_MARKER_CONTROL_API_ID_LAST;
-    using enum_type                           = rocprofiler_marker_control_api_id_t;
+    static constexpr auto external_correlation_id_domain_idx =
+        ROCPROFILER_EXTERNAL_CORRELATION_REQUEST_MARKER_CONTROL_API;
 };
 
 template <>
 struct roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_RoctxName>
 : roctx_domain_info<ROCPROFILER_MARKER_TABLE_ID_LAST>
 {
+    using enum_type                           = rocprofiler_marker_name_api_id_t;
     static constexpr auto callback_domain_idx = ROCPROFILER_CALLBACK_TRACING_MARKER_NAME_API;
     static constexpr auto buffered_domain_idx = ROCPROFILER_BUFFER_TRACING_MARKER_NAME_API;
     static constexpr auto none                = ROCPROFILER_MARKER_NAME_API_ID_NONE;
     static constexpr auto last                = ROCPROFILER_MARKER_NAME_API_ID_LAST;
-    using enum_type                           = rocprofiler_marker_name_api_id_t;
+    static constexpr auto external_correlation_id_domain_idx =
+        ROCPROFILER_EXTERNAL_CORRELATION_REQUEST_MARKER_NAME_API;
 };
 }  // namespace marker
 }  // namespace rocprofiler