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/counters/tests/core.cpp

@@ -365,6 +365,7 @@ struct expected_dispatch
     rocprofiler_queue_id_t           queue_id       = {.handle = 0};
     rocprofiler_agent_id_t           agent_id       = {.handle = 0};
     uint64_t                         kernel_id      = 0;
+    uint64_t                         dispatch_id    = 0;
     rocprofiler_correlation_id_t     correlation_id = {.internal = 0, .external = {.value = 0}};
     rocprofiler_dim3_t               workgroup_size = {0, 0, 0};
     rocprofiler_dim3_t               grid_size      = {0, 0, 0};
@@ -383,9 +384,11 @@ user_dispatch_cb(rocprofiler_profile_counting_dispatch_data_t dispatch_data,
     auto queue_id       = dispatch_data.queue_id;
     auto correlation_id = dispatch_data.correlation_id;
     auto kernel_id      = dispatch_data.kernel_id;
+    auto dispatch_id    = dispatch_data.dispatch_id;
 
     EXPECT_EQ(sizeof(rocprofiler_profile_counting_dispatch_data_t), dispatch_data.size);
     EXPECT_EQ(expected.kernel_id, kernel_id);
+    EXPECT_EQ(expected.dispatch_id, dispatch_id);
     EXPECT_EQ(expected.agent_id, agent_id);
     EXPECT_EQ(expected.queue_id.handle, queue_id.handle);
     EXPECT_EQ(expected.correlation_id.internal, correlation_id.internal);
@@ -480,14 +483,22 @@ TEST(core, check_callbacks)
                                   pkt.kernel_dispatch.grid_size_y,
                                   pkt.kernel_dispatch.grid_size_z};
             expected.kernel_id      = count++;
+            expected.dispatch_id    = count++;
             expected.queue_id       = qid;
             expected.agent_id       = fq.get_agent().get_rocp_agent()->id;
 
             hsa::Queue::queue_info_session_t::external_corr_id_map_t extern_ids = {};
 
             auto user_data = rocprofiler_user_data_t{.value = corr_id.internal};
-            auto ret_pkt   = counters::queue_cb(
-                &ctx, cb_info, fq, pkt, expected.kernel_id, &user_data, extern_ids, &corr_id);
+            auto ret_pkt   = counters::queue_cb(&ctx,
+                                              cb_info,
+                                              fq,
+                                              pkt,
+                                              expected.kernel_id,
+                                              expected.dispatch_id,
+                                              &user_data,
+                                              extern_ids,
+                                              &corr_id);
 
             ASSERT_TRUE(ret_pkt) << fmt::format("Expected a packet to be generated for - {}",
                                                 metric.name());