Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A simple library for working with the Proby task monitoring application.

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 Gemfile
Octocat-spinner-32 Gemfile.lock
Octocat-spinner-32 HISTORY.md
Octocat-spinner-32 README.md
Octocat-spinner-32 Rakefile
Octocat-spinner-32 proby.gemspec
README.md

Proby

A simple library for working with the Proby task monitoring application.

Build Status

Installation

RubyGems

Proby can be installed using RubyGems

gem install proby

Inside your script, be sure to

require "rubygems"
require "proby"

Bundler

If you're using Bundler, add the following to your Gemfile

gem "proby"

and then run

bundle install

Setup

Before notifications can be sent, you must tell Proby your API key. This only needs to be done once, and should ideally be done inside your apps initialization code.

Proby.api_key = "b4fe1200c105012efde3482a1411a947"

In addition, you can optionally give Proby a logger to use.

Proby.logger = Rails.logger

Sending Notifications

The easiest way to have Proby monitor your task is by wrapping your code in a call to Proby's monitor function.

Proby.monitor(task_api_id) do
  # Do something here
end

You can also send the start and finish notifications manually via calls to send_start_notification and send_finish_notification.

Proby.send_start_notification(task_api_id)
# Do something here
Proby.send_finish_notification(task_api_id)

Specifying the task_api_id when calling any of the the notification methods is optional. If it is not provided, Proby will use the value of the PROBY_TASK_ID environment variable. If no task id is specified in the method call, and no value is set in the PROBY_TASK_ID environment variable, then no notification will be sent.

The Resque Plugin

The Resque plugin will automatically send start and finish notifications to Proby when your job starts and finishes. Simply extend Proby::ResquePlugin in your Resque job. The task id can either be pulled from the PROBY_TASK_ID environment variable, or specified in the job itself by setting the @proby_id attribute to the task id.

class SomeJob
  extend Proby::ResquePlugin
  @proby_id = 'abc123'  # Or simply let it use the value in the PROBY_TASK_ID environment variable

  self.perform
    do_stuff
  end
end

Managing Tasks

The Proby::ProbyTask class can be used to create, read, update, delete, pause, and unpause your tasks on Proby.

my_tasks = Proby::ProbyTask.find(:all)
a_specific_task = Proby::ProbyTask.find("the_proby_task_id")

task = Proby::ProbyTask.create(:name => 'Task name', :crontab => '* * * * *')

task.name = "New name"
task.save

task.pause
task.unpause

task.delete

API Doc

http://rdoc.info/github/signal/proby-ruby/master/frames

Something went wrong with that request. Please try again.