nvtx.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
 
#ifndef MXNET_COMMON_CUDA_NVTX_H_
#define MXNET_COMMON_CUDA_NVTX_H_
 
#if MXNET_USE_CUDA && MXNET_USE_NVTX
#include <cuda.h>
#include <cuda_runtime.h>
#include <nvToolsExtCuda.h>
#include <vector>
#include <string>
#include <cstring>
 
namespace mxnet {
namespace common {
namespace cuda {
 
class NVTXDuration {
 public:
  explicit NVTXDuration(const char* name) noexcept : range_id_(0), name_(name) {}
 
  inline void start() {
    range_id_ = nvtxRangeStartA(name_);
  }
 
  inline void stop() {
    nvtxRangeEnd(range_id_);
  }
 
 private:
  nvtxRangeId_t range_id_;
  const char* name_;
};
 
// Utility class for NVTX
class nvtx {
 public:
  // Palette of colors (make sure to add new colors to the vector in nameToColor()).
  static const uint32_t kRed     = 0xFF0000;
  static const uint32_t kGreen   = 0x00FF00;
  static const uint32_t kBlue    = 0x0000FF;
  static const uint32_t kYellow  = 0xB58900;
  static const uint32_t kOrange  = 0xCB4B16;
  static const uint32_t kRed1    = 0xDC322F;
  static const uint32_t kMagenta = 0xD33682;
  static const uint32_t kViolet  = 0x6C71C4;
  static const uint32_t kBlue1   = 0x268BD2;
  static const uint32_t kCyan    = 0x2AA198;
  static const uint32_t kGreen1  = 0x859900;
 
  static void gpuRangeStart(const uint32_t rgb, const std::string& range_name) {
    nvtxEventAttributes_t att;
    att.version       = NVTX_VERSION;
    att.size          = NVTX_EVENT_ATTRIB_STRUCT_SIZE;
    att.colorType     = NVTX_COLOR_ARGB;
    att.color         = rgb | 0xff000000;
    att.messageType   = NVTX_MESSAGE_TYPE_ASCII;
    att.message.ascii = range_name.c_str();
    nvtxRangePushEx(&att);
  }
 
  // Utility to map a range name prefix to a random color based on its hash
  static uint32_t nameToColor(const std::string& range_name, int prefix_len) {
    static std::vector<uint32_t> colors{
        kRed, kGreen, kBlue, kYellow, kOrange, kRed1, kMagenta, kViolet, kBlue1, kCyan, kGreen1};
    std::string s(range_name, 0, prefix_len);
    std::hash<std::string> hash_fn;
    return colors[hash_fn(s) % colors.size()];
  }
 
  // Utility to map a range name to a random color based on its hash
  static uint32_t nameToColor(const std::string& range_name) {
    return nameToColor(range_name, range_name.size());
  }
 
  static void gpuRangeStop() {
    nvtxRangePop();
  }
};
 
}  // namespace cuda
}  // namespace common
}  // namespace mxnet
 
#endif  // MXNET_UDE_CUDA && MXNET_USE_NVTX
#endif  // MXNET_COMMON_CUDA_NVTX_H_