40a6eec4e1
I'm not sure if this is going to be useful, but it's fairly harmless, and is annoying me by being on a branch. |
||
---|---|---|
hooks | ||
src/github.com/matrix-org/rageshake | ||
vendor | ||
.gitignore | ||
.travis.yml | ||
CONTRIBUTING.rst | ||
LICENSE | ||
rageshake.sample.yaml | ||
README.md |
rageshake
Web service which collects and serves bug reports.
rageshake requires Go version 1.7 or later.
To run it, do:
go get github.com/constabulary/gb/...
gb build
./bin/rageshake
Optional parameters:
-config <path>
: The path to a YAML config file; see rageshake.sample.yaml for more information.-listen <address>
: TCP network address to listen for HTTP requests on. Example::9110
.
HTTP endpoints
The following HTTP endpoints are exposed:
GET /api/listing/
Serves submitted bug reports. Protected by basic HTTP auth using the username/password provided in the environment. A browsable list, collated by report submission date and time.
POST /api/submit
Submission endpoint: this is where applications should send their reports.
The body of the request should be a JSON object with the following fields:
-
text
: A textual description of the problem. Included in thedetails.log.gz
file. -
user_agent
: Application user-agent. Included in thedetails.log.gz
file. -
app
: Identifier for the application (eg 'riot-web'). Should correspond to a mapping configured in the configuration file for github issue reporting to work. -
version
: Application version. Included in thedetails.log.gz
file. -
logs
: an of log files. Each entry in the list should be an object with the following fields:id
: textual identifier for the logs. Currently ignored.lines
: log data. Lines should be separated by newline characters (encoded as\n
, as normal in JSON).
The response (if successful) will be a JSON object with the following fields:
report_url
: A URL where the user can track their bug report. Omitted if issue submission was disabled.