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/include/rocprofiler-sdk/buffer_tracing.h

@@ -122,20 +122,32 @@ typedef struct
 /**
  * @brief ROCProfiler Buffer Kernel Dispatch Tracer Record.
  */
-typedef struct
+typedef struct rocprofiler_buffer_tracing_kernel_dispatch_record_t
 {
-    uint64_t                          size;  ///< size of this struct
-    rocprofiler_buffer_tracing_kind_t kind;  ///< ::ROCPROFILER_BUFFER_TRACING_KERNEL_DISPATCH
-    rocprofiler_correlation_id_t      correlation_id;        ///< correlation ids for record
-    rocprofiler_timestamp_t           start_timestamp;       ///< start time in nanoseconds
-    rocprofiler_timestamp_t           end_timestamp;         ///< end time in nanoseconds
-    rocprofiler_agent_id_t            agent_id;              ///< agent kernel was dispatched on
-    rocprofiler_queue_id_t            queue_id;              ///< queue kernel was dispatched on
-    rocprofiler_kernel_id_t           kernel_id;             ///< identifier for kernel
-    uint32_t                          private_segment_size;  /// runtime private memory segment size
-    uint32_t                          group_segment_size;    /// runtime group memory segment size
-    rocprofiler_dim3_t                workgroup_size;  /// runtime workgroup size (grid * threads)
-    rocprofiler_dim3_t                grid_size;       /// runtime grid size
+    uint64_t                                size;  ///< size of this struct
+    rocprofiler_buffer_tracing_kind_t       kind;  ///< ::ROCPROFILER_BUFFER_TRACING_KERNEL_DISPATCH
+    rocprofiler_kernel_dispatch_operation_t operation;       ///<
+    rocprofiler_correlation_id_t            correlation_id;  ///< correlation ids for record
+    rocprofiler_thread_id_t                 thread_id;       ///< id for thread that launched kernel
+    rocprofiler_timestamp_t                 start_timestamp;  ///< start time in nanoseconds
+    rocprofiler_timestamp_t                 end_timestamp;    ///< end time in nanoseconds
+    rocprofiler_agent_id_t                  agent_id;         ///< agent kernel was dispatched on
+    rocprofiler_queue_id_t                  queue_id;         ///< queue kernel was dispatched on
+    rocprofiler_kernel_id_t                 kernel_id;        ///< identifier for kernel
+    rocprofiler_dispatch_id_t               dispatch_id;      ///< unique id for each dispatch
+    uint32_t                                private_segment_size;
+    uint32_t                                group_segment_size;
+    rocprofiler_dim3_t                      workgroup_size;
+    rocprofiler_dim3_t                      grid_size;
+
+    /// @var private_segment_size
+    /// @brief runtime private memory segment size
+    /// @var group_segment_size
+    /// @brief runtime group memory segment size
+    /// @var workgroup_size
+    /// @brief runtime workgroup size (grid * threads)
+    /// @var grid_size
+    /// @brief runtime grid size
 } rocprofiler_buffer_tracing_kernel_dispatch_record_t;
 
 /**