Peter Hawkins 76fa5e8a4a [XLA:Python] Implement on-device heap profiling support for JAX.
Adds an `xla_client.heap_profile(client)` API which produces a gzip-compressed profile.proto protocol buffer containing an on-device heap profile, suitable for visualization via the pprof tool (https://github.com/google/pprof).

The heap profile includes buffers and executables allocated by JAX.

PiperOrigin-RevId: 316138726
Change-Id: I1b263f8033c6fc07466a362ff3d6f65a55334def
2020-06-12 11:18:13 -07:00

75 lines
1.9 KiB
C++

/* Copyright 2020 The TensorFlow Authors. All Rights Reserved.
Licensed 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 TENSORFLOW_COMPILER_XLA_PYTHON_TRACEBACK_H_
#define TENSORFLOW_COMPILER_XLA_PYTHON_TRACEBACK_H_
#include <memory>
#include <string>
#include <vector>
#include "absl/container/inlined_vector.h"
#include "pybind11/pybind11.h"
namespace xla {
// Represents a Python traceback.
class Traceback {
public:
// Require GIL.
static std::shared_ptr<Traceback> Get();
// Require GIL.
static bool enabled() { return enabled_; }
// Require GIL.
static void SetEnabled(bool enabled);
Traceback() = default;
~Traceback();
Traceback(const Traceback&) = delete;
Traceback(Traceback&&) = delete;
Traceback& operator=(const Traceback&) = delete;
Traceback& operator=(Traceback&&) = delete;
// Requires the GIL be held.
std::string ToString() const;
struct Frame {
pybind11::str file_name;
pybind11::str function_name;
int function_start_line;
int line_num;
std::string ToString() const;
};
std::vector<Frame> Frames() const;
const absl::InlinedVector<std::pair<PyCodeObject*, int>, 32>& raw_frames()
const {
return frames_;
}
private:
absl::InlinedVector<std::pair<PyCodeObject*, int>, 32> frames_;
// Protected by GIL.
static bool enabled_;
};
} // namespace xla
#endif // TENSORFLOW_COMPILER_XLA_PYTHON_TRACEBACK_H_