https://github.com/udzura/rbbcc

BCC port for MRI - this is unofficial bonsai project.
https://github.com/udzura/rbbcc

bcc dl ebpf ruby tracing

Last synced: 22 days ago
JSON representation

BCC port for MRI - this is unofficial bonsai project.

• Host: GitHub
• URL: https://github.com/udzura/rbbcc
• Owner: udzura
• License: apache-2.0
• Created: 2019-07-27T16:09:05.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-02-13T14:06:19.000Z (9 months ago)
• Last Synced: 2024-05-01T23:33:24.580Z (6 months ago)
• Topics: bcc, dl, ebpf, ruby, tracing
• Language: Ruby
• Homepage: https://github.com/iovisor/bcc
• Size: 2.26 MB
• Stars: 47
• Watchers: 9
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RbBCC

[![Gem Version](https://badge.fury.io/rb/rbbcc.svg)](https://badge.fury.io/rb/rbbcc) [![CI Status](https://github.com/udzura/rbbcc/workflows/Tests/badge.svg)](https://github.com/udzura/rbbcc/actions?query=workflow%3ATests)

RbBCC is a port of [BCC](https://github.com/iovisor/bcc) in MRI. See iovisor project page.

![Movie](examples/example.gif)

This gem requires `libbcc.so`. Please install it [following BCC's instruction](https://github.com/iovisor/bcc/blob/master/INSTALL.md).

## Installation

Add this line to your application's Gemfile:

```ruby

gem 'rbbcc'

```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install rbbcc

## Usage

```ruby

require 'rbbcc' 

code = <-5025  [003] d...  1237.796956: : Hello, World!

            runc-5025  [003] d...  1237.797133: : Hello, World!

           httpd-4967  [000] d...  1237.797156: : Hello, World!

           httpd-4967  [000] d...  1237.797198: : Hello, World!

           httpd-4967  [000] d...  1237.797340: : Hello, World!

            runc-5025  [003] d...  1237.797464: : Hello, World!

```

## Documents

See [docs/](docs/) for getting started and tutorial.

## Development

After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/udzura/rbbcc.