README
¶
pd
/pe.de/ - command line tool to query PagerDuty for the current on-calls
Setup
Install the pd binary via brew on macOS, or find the respective binary of the latest release.
brew install homeport/tap/pd
Create a .pd.yml file in your home directory that contains a PagerDuty authentication token. Go to your PagerDuty profile settings and under "User Settings" you will find a Create API User Token button.
Next, you'll need to configure different shifts in the .pd.yml file. This step can be skipped if you don't need to use the current-shift command. The file should now look somewhat like this:
authtoken: bm9ub25vbm9ub25vbm8K
own-shift: Team Bar
shift-times:
- end: 08:00
name: Team Foo
start: 00:00
- end: 16:00
name: Team Bar
start: 08:00
- end: 00:00
name: Team Foobar
start: 16:00
Commands
pd on-call
Displays all current on calls.
pd current-shift
Displays which shift is currently on-call (if shifts are configured in the .pd.yml file).
pd set-own-shift [shift-name]
Updates own-shift in .pd.yml file.
pd list-alerts
Lists all alerts that happened in a specified timeframe.
| Flag | Description |
|---|---|
| --id <user-ID> | list all alerts for the user |
| --from <time> | lists all alerts after the specified time |
| --to <time> | lists all alerts until the specified time |
user-ID is a 7 character long ID found on PagerDuty.
time has to be provided using the format RFC3339 (2006-01-02T15:04:05Z07:00)
If --from and --to are both not used, all non-resolved issues for the user are displayed.
Directories