Add support for oneCCL and Synchronization events.

libkineto/README.md

@@ -73,6 +73,8 @@ For more information on how to run on-demand profiling, please refer to the Dyno
 
 The default trace output is a JSON file that can be visualized in Chrome Trace Viewer or Perfetto. The trace output is generated by the `ChromeTraceLogger` instance. The `ChromeTraceLogger` writes to a JSON file using `std::ofstream` in `output_json.cpp` to maximize performance during export. This instance is created by the `ActivityProfilerController` and is stored in the `ActivityLoggerFactory` alongside its protocol. Using this schema, Kineto supports multiple trace output formats.
 
+- Intel XCCL: to enable collecting of oneCCL host events, `INTEL_LIBITTNOTIFY64` enviroment variable have to be set as path to `pti_view.so` location.
+
 ## Full documentation
 We strive to keep our source files readable. The best and up-to-date
 documentation for implementation specifics is available in the source files.

libkineto/include/ActivityType.h

@@ -51,8 +51,9 @@ enum class ActivityType {
   PRIVATEUSE1_DRIVER = 25, // host side privateUse1 driver events
 
   XPU_SCOPE_PROFILER = 26, // XPUPTI Profiler scope for performance metrics
+  XPU_SYNC = 27, // XPU synchronization events
 
-  ENUM_COUNT = 27, // This is to add buffer and not used for any profiling logic. Add
+  ENUM_COUNT = 28, // This is to add buffer and not used for any profiling logic. Add
   // your new type before it.
   OPTIONAL_ACTIVITY_TYPE_START = GLOW_RUNTIME,
 };
@@ -97,6 +98,7 @@ inline constexpr std::array<_ActivityTypeName, activityTypeCount + 1> _activityT
     {"privateuse1_runtime", ActivityType::PRIVATEUSE1_RUNTIME},
     {"privateuse1_driver", ActivityType::PRIVATEUSE1_DRIVER},
     {"xpu_scope_profiler", ActivityType::XPU_SCOPE_PROFILER},
+    {"xpu_sync", ActivityType::XPU_SYNC},
     {"ENUM_COUNT", ActivityType::ENUM_COUNT},
 }};
 

libkineto/src/plugin/xpupti/CMakeLists.txt

@@ -49,7 +49,8 @@ if(TARGET Pti::pti_view)
     list(APPEND XPUPTI_INCLUDE_DIR ${PTI_INCLUDE_DIR})
     set(XPUPTI_INCLUDE_DIR ${XPUPTI_INCLUDE_DIR} PARENT_SCOPE)
 
-    set(XPUPTI_BUILD_FLAG "-DHAS_XPUPTI" PARENT_SCOPE)
+    set(XPUPTI_BUILD_FLAG "-DHAS_XPUPTI")
+    set(XPUPTI_BUILD_FLAG ${XPUPTI_BUILD_FLAG} PARENT_SCOPE)
 
     message(STATUS " XPU_xpupti_LIBRARY = ${XPU_xpupti_LIBRARY}")
     message(STATUS " XPUPTI_INCLUDE_DIR = ${XPUPTI_INCLUDE_DIR}")

libkineto/src/plugin/xpupti/XpuptiActivityApi.cpp

@@ -7,6 +7,7 @@
  */
 
 #include "XpuptiActivityApi.h"
+#include "Logger.h"
 
 #include <chrono>
 #include <stdexcept>
@@ -260,6 +261,20 @@ void XpuptiActivityApi::enableXpuptiActivities(
         XPUPTI_CALL(ptiViewEnable(PTI_VIEW_COLLECTION_OVERHEAD));
         break;
 
+#if PTI_VERSION_AT_LEAST(0, 17)
+      case ActivityType::COLLECTIVE_COMM: {
+        auto rc = ptiViewEnable(PTI_VIEW_COMMUNICATION);
+        if (rc != PTI_SUCCESS) {
+          LOG(WARNING) << "Failed to enable PTI_VIEW_COMMUNICATION: "
+                       << ptiResultTypeToString(rc);
+        }
+        break;
+      }
+#endif
+      case ActivityType::XPU_SYNC:
+        XPUPTI_CALL(ptiViewEnable(PTI_VIEW_DEVICE_SYNCHRONIZATION));
+        break;
+
       default:
         break;
     }
@@ -304,6 +319,20 @@ void XpuptiActivityApi::disablePtiActivities(
         XPUPTI_CALL(ptiViewDisable(PTI_VIEW_COLLECTION_OVERHEAD));
         break;
 
+#if PTI_VERSION_AT_LEAST(0, 17)
+      case ActivityType::COLLECTIVE_COMM: {
+        auto rc = ptiViewDisable(PTI_VIEW_COMMUNICATION);
+        if (rc != PTI_SUCCESS) {
+          LOG(WARNING) << "Failed to disable PTI_VIEW_COMMUNICATION: "
+                       << ptiResultTypeToString(rc);
+        }
+        break;
+      }
+#endif
+      case ActivityType::XPU_SYNC:
+        XPUPTI_CALL(ptiViewDisable(PTI_VIEW_DEVICE_SYNCHRONIZATION));
+        break;
+
       default:
         break;
     }

libkineto/src/plugin/xpupti/XpuptiActivityHandlers.cpp

@@ -95,18 +95,6 @@ inline void XpuptiActivityProfilerSession::handleCorrelationActivity(
   }
 }
 
-std::string XpuptiActivityProfilerSession::getApiName(
-    const pti_view_record_api_t* activity) {
-#if PTI_VERSION_AT_LEAST(0, 11)
-  const char* api_name = nullptr;
-  XPUPTI_CALL(
-      ptiViewGetApiIdName(activity->_api_group, activity->_api_id, &api_name));
-  return std::string(api_name);
-#else
-  return std::string(activity->_name);
-#endif
-}
-
 inline std::string memcpyName(
     pti_view_memcpy_type kind,
     pti_view_memory_type src,
@@ -183,8 +171,6 @@ void XpuptiActivityProfilerSession::handleRuntimeKernelMemcpyMemsetActivities(
 
   traceBuffer_.span.opCount += 1;
   traceBuffer_.gpuOpCount += 1;
-  const ITraceActivity* linked =
-      linkedActivity(activity->_correlation_id, cpuCorrelationMap_);
 
   if constexpr (handleRuntimeActivities) {
     traceBuffer_.emplace_activity(
@@ -209,11 +195,14 @@ void XpuptiActivityProfilerSession::handleRuntimeKernelMemcpyMemsetActivities(
 
   trace_activity->startTime = activity->_start_timestamp;
   trace_activity->endTime = activity->_end_timestamp;
-  trace_activity->id = activity->_correlation_id;
   trace_activity->threadId = activity->_thread_id;
   trace_activity->flow.id = activity->_correlation_id;
   trace_activity->flow.type = libkineto::kLinkAsyncCpuGpu;
-  trace_activity->linked = linked;
+
+  trace_activity->id = activity->_correlation_id;
+  trace_activity->linked =
+      linkedActivity(activity->_correlation_id, cpuCorrelationMap_);
+  trace_activity->addMetadata("correlation", activity->_correlation_id);
 
   if constexpr (handleRuntimeActivities) {
     trace_activity->device = activity->_process_id;
@@ -271,8 +260,6 @@ void XpuptiActivityProfilerSession::handleRuntimeKernelMemcpyMemsetActivities(
         "l0 queue", handleToHexString(activity->_queue_handle));
   }
 
-  trace_activity->addMetadata("correlation", activity->_correlation_id);
-
   if constexpr (handleKernelActivities) {
     if (activity->_source_file_name) {
       trace_activity->addMetadataQuoted(
@@ -301,6 +288,116 @@ void XpuptiActivityProfilerSession::handleRuntimeKernelMemcpyMemsetActivities(
   trace_activity->log(logger);
 }
 
+namespace {
+std::string getStringFromSynchronizationType(
+    const pti_view_synchronization_type& synchronization_type) {
+  using pv_st = pti_view_synchronization_type;
+  static const std::unordered_map<pv_st, std::string> name_map{
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_UNKNOWN, "UNKNOWN"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_GPU_BARRIER_EXECUTION,
+       "GPU_BARRIER_EXECUTION"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_GPU_BARRIER_MEMORY,
+       "GPU_BARRIER_MEMORY"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_HOST_FENCE, "HOST_FENCE"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_HOST_EVENT, "HOST_EVENT"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_HOST_COMMAND_LIST,
+       "HOST_COMMAND_LIST"},
+      {pv_st::PTI_VIEW_SYNCHRONIZATION_TYPE_HOST_COMMAND_QUEUE,
+       "HOST_COMMAND_QUEUE"},
+  };
+
+  const auto& name_string = name_map.find(synchronization_type);
+  if (name_string == name_map.end()) {
+    const std::string error_message =
+        "404: Not found string literal for this synchronization type: " +
+        std::to_string(synchronization_type);
+    return error_message;
+  }
+  return name_string->second;
+}
+} // namespace
+
+void XpuptiActivityProfilerSession::handleSynchronizationActivity(
+    const pti_view_record_synchronization* activity,
+    ActivityLogger& logger) {
+  const auto& activity_record = *activity;
+  const auto record_name = getApiName(activity);
+
+  const bool isGpuSync =
+      activity_record._synch_type == PTI_VIEW_SYNCHRONIZATION_TYPE_GPU_BARRIER_EXECUTION ||
+      activity_record._synch_type == PTI_VIEW_SYNCHRONIZATION_TYPE_GPU_BARRIER_MEMORY;
+
+  traceBuffer_.span.opCount += 1;
+  if (isGpuSync) {
+    traceBuffer_.gpuOpCount += 1;
+  }
+  traceBuffer_.emplace_activity(traceBuffer_.span, ActivityType::XPU_SYNC, record_name);
+  auto& synchronization_activity = *(traceBuffer_.activities.back());
+
+  synchronization_activity.startTime = activity_record._start_timestamp;
+  synchronization_activity.endTime = activity_record._end_timestamp;
+  synchronization_activity.device = -1;
+  synchronization_activity.resource = activity_record._thread_id;
+  synchronization_activity.threadId = activity_record._thread_id;
+
+  synchronization_activity.id = activity->_correlation_id;
+  synchronization_activity.linked =
+      linkedActivity(activity->_correlation_id, cpuCorrelationMap_);
+  synchronization_activity.addMetadata(
+      "correlation", activity_record._correlation_id);
+
+  synchronization_activity.addMetadataQuoted(
+      "Type", getStringFromSynchronizationType(activity_record._synch_type));
+  synchronization_activity.addMetadataQuoted("Context_handle", handleToHexString(activity_record._context_handle));
+  synchronization_activity.addMetadataQuoted("Queue_handle", handleToHexString(activity_record._queue_handle));
+  synchronization_activity.addMetadataQuoted("Event_handle", handleToHexString(activity_record._event_handle));
+  synchronization_activity.addMetadata("Number_wait_events", activity_record._number_wait_events);
+  synchronization_activity.addMetadata("Return_code", activity_record._return_code);
+
+  if (outOfRange(&synchronization_activity)) {
+    traceBuffer_.span.opCount -= 1;
+    if (isGpuSync) {
+      traceBuffer_.gpuOpCount -= 1;
+    }
+    removeCorrelatedPtiActivities(&synchronization_activity);
+    traceBuffer_.activities.pop_back();
+    return;
+  }
+
+  synchronization_activity.log(logger);
+}
+
+#if PTI_VERSION_AT_LEAST(0, 17)
+void XpuptiActivityProfilerSession::handleCommunicationActivity(
+    const pti_view_record_comms* activity,
+    ActivityLogger& logger) {
+  const auto& activity_record = *activity;
+  const std::string activity_name{activity_record._name};
+  const std::string xccl_prefix{"xccl::"};
+  const auto record_name = xccl_prefix + activity_name;
+
+  traceBuffer_.span.opCount += 1;
+  traceBuffer_.emplace_activity(traceBuffer_.span, ActivityType::COLLECTIVE_COMM, record_name);
+  auto& comms_activity = *(traceBuffer_.activities.back());
+
+  comms_activity.startTime = activity_record._start_timestamp;
+  comms_activity.endTime = activity_record._end_timestamp;
+  comms_activity.device = activity_record._process_id;
+  comms_activity.resource = activity_record._thread_id;
+  comms_activity.threadId = activity_record._thread_id;
+
+  comms_activity.addMetadata("Communicator_id", activity_record._communicator_id);
+
+  if (outOfRange(&comms_activity)) {
+    traceBuffer_.span.opCount -= 1;
+    traceBuffer_.activities.pop_back();
+    return;
+  }
+
+  comms_activity.log(logger);
+}
+#endif
+
 void XpuptiActivityProfilerSession::handleOverheadActivity(
     const pti_view_record_overhead* activity,
     ActivityLogger& logger) {
@@ -375,6 +472,17 @@ void XpuptiActivityProfilerSession::handlePtiActivity(
       handleOverheadActivity(
           reinterpret_cast<const pti_view_record_overhead*>(record), logger);
       break;
+    case PTI_VIEW_DEVICE_SYNCHRONIZATION:
+      handleSynchronizationActivity(
+          reinterpret_cast<const pti_view_record_synchronization*>(record),
+          logger);
+      break;
+#if PTI_VERSION_AT_LEAST(0, 17)
+    case PTI_VIEW_COMMUNICATION:
+      handleCommunicationActivity(
+          reinterpret_cast<const pti_view_record_comms*>(record), logger);
+      break;
+#endif
     default:
       errors_.push_back(
           "Unexpected activity type: " + std::to_string(record->_view_kind));

libkineto/src/plugin/xpupti/XpuptiActivityProfilerSession.h

@@ -76,13 +76,27 @@ class XpuptiActivityProfilerSession : public libkineto::IActivityProfilerSession
   using pti_view_record_api_t = pti_view_record_sycl_runtime;
 #endif
 
-  std::string getApiName(const pti_view_record_api_t* activity);
+  template <typename PTI_VIEW>
+  std::string getApiName(const PTI_VIEW* activity) {
+#if PTI_VERSION_AT_LEAST(0, 11)
+    const char* api_name = nullptr;
+    XPUPTI_CALL(ptiViewGetApiIdName(
+        activity->_api_group, activity->_api_id, &api_name));
+    return std::string(api_name);
+#else
+    return std::string(activity->_name);
+#endif
+  }
 
   template <class pti_view_memory_record_type>
   void handleRuntimeKernelMemcpyMemsetActivities(ActivityType activityType,
                                                  const pti_view_memory_record_type* activity,
                                                  ActivityLogger& logger);
 
+  void handleSynchronizationActivity(const pti_view_record_synchronization* activity, ActivityLogger& logger);
+#if PTI_VERSION_AT_LEAST(0, 17)
+  void handleCommunicationActivity(const pti_view_record_comms* activity, ActivityLogger& logger);
+#endif
   void handleOverheadActivity(const pti_view_record_overhead* activity, ActivityLogger& logger);
   void handlePtiActivity(const pti_view_record_base* record, ActivityLogger& logger);