Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

plugins/http-requests: documentation and tutorial #1879

Conversation

alepuccetti
Copy link

Write documentation and little tutorial for the HTTP requests plugin.
The goal is to introduce the plugin concepts to users and developers.

The UI shows the number of requests as a single value and graph which are updated every second.
The HTTP requests plugin does not use any application-level instrumentation, it has a negligible performance toll (metrics are obtained in-kernel without any packet copying to userspace).

**Note:** This plugin needs a [recent kernel version with eBPF support](https://github.com/iovisor/bcc/blob/master/INSTALL.md#kernel-configuration).

This comment was marked as abuse.

This comment was marked as abuse.

This comment was marked as abuse.

The HTTP requests plugin does not use any application-level instrumentation, it has a negligible performance toll (metrics are obtained in-kernel without any packet copying to userspace).

**Note:** This plugin needs a [recent kernel version with eBPF support](https://github.com/iovisor/bcc/blob/master/INSTALL.md#kernel-configuration).
It will not compile on current [dlite](https://github.com/nlf/dlite) and boot2docker hosts.

This comment was marked as abuse.

/bin/nc $TARGET_IP $TARGET_PORT &

while true; do
curl http://$TARGET_IP:$TARGET_PORT &> /dev/null

This comment was marked as abuse.


* Run the HTTP requests plugin `cd examples/plugins/http-requests ; make`.
* In another terminal, run an `nginx` instance `docker run --name http-requests-nginx -p 8080:80 nginx`
* Run `sh test-http-requests.sh`, this script will open a long-term connection with the web server and then start downloading the main page until Ctrl+c is sent by the user.

This comment was marked as abuse.

This comment was marked as abuse.

This comment was marked as abuse.

* Open the `http-requests-nginx` container.
* Click on `nginx: worker process` in the "Processes" table.

## Report

This comment was marked as abuse.

@alepuccetti alepuccetti force-pushed the alessandro/http-requests-docs branch from 2d76426 to fe0d5ef Compare September 22, 2016 13:49
Write documentation and little tutorial for the HTTP requests plugin.
The goal is to introduce the plugin concepts to users and developers.
@alepuccetti alepuccetti force-pushed the alessandro/http-requests-docs branch from fe0d5ef to 1f6ceea Compare September 22, 2016 14:06

while true; do
curl http://$TARGET_IP:$TARGET_PORT &> /dev/null
sleep 0.042

This comment was marked as abuse.

This comment was marked as abuse.

This comment was marked as abuse.

@alepuccetti
Copy link
Author

Closing this pull request because this plugin is moved to a different repository and renamed.

https://github.com/weaveworks-plugins/scope-http-statistics

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants