https://github.com/cloudfoundry-community/cf-plugin-kibana-me-logs
Launches the Kibana UI (from kibana-me-logs) for an application
https://github.com/cloudfoundry-community/cf-plugin-kibana-me-logs
Last synced: 9 months ago
JSON representation
Launches the Kibana UI (from kibana-me-logs) for an application
- Host: GitHub
- URL: https://github.com/cloudfoundry-community/cf-plugin-kibana-me-logs
- Owner: cloudfoundry-community
- Created: 2015-03-18T23:06:17.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2017-03-22T02:01:36.000Z (over 9 years ago)
- Last Synced: 2024-06-19T10:05:53.254Z (about 2 years ago)
- Language: Go
- Homepage:
- Size: 43.9 KB
- Stars: 7
- Watchers: 13
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Overview
========
Launches the Kibana UI (from [kibana-me-logs](https://github.com/cloudfoundry-community/kibana-me-logs)\) for an application.
Learn more about using CLI plugins from https://blog.starkandwayne.com/2015/03/04/installing-cloud-foundry-cli-plugins/
Installation
------------
From community plugin repo:
```
$ cf add-plugin-repo community https://plugins.cfapps.io/
$ cf install-plugin kibana-me-logs -r community
```
From source, see the Development section below.
Upgrade
-------
To upgrade you must first uninstall the plugin and then install as above:
```
$ cf uninstall-plugin kibana-me-logs
```
Usage
-----
```
$ cf kibana-me-logs [--no-auth]
```
Will launch the Kibana UI and show logs for the requested app.
It assumes that `` is the an app bound to the same `logstash14` logstash service.
`cf kibana-me-logs` will automatically generate a user/password for you to use in conjunction with your kibana-me-logs app, unless you provide the --no-auth option.
Advanced Usage
--------------
To use a custom kibana-me-logs repo, specify the repo URL in the `KIBANA_ME_LOGS_REPO`
environment variable.
To bypass cloning kibana-me-logs, and use a local source directory, specify the path in the
`KIBANA_ME_LOGS_APP_DIR` environment variable.
To use a custom temp directory (overriding `/tmp`), for holding the kibana-me-logs repo being
pushed, use the `TMP_DIR` environment variable.
Development
-----------
To build from source, first fetch the Cloud Foundry CLI project and generate its internal go files:
```
go get github.com/cloudfoundry/cli/cf
cd $GOPATH/src/github.com/cloudfoundry/cli
./bin/build
```
Next fetch this project:
```
$ go get github.com/cloudfoundry-community/cf-plugin-kibana-me-logs
$ cf install-plugin $GOPATH/bin/cf-plugin-kibana-me-logs
```
There is a helper to uninstall, build, install, and run the plugin:
```
./bin/run.sh
```
Or manually:
```
cf uninstall-plugin kibana-me-logs
go get ./...
cf install-plugin $GOPATH/bin/cf-plugin-kibana-me-logs
cf kibana-me-logs
```
Or a one-liner:
```
cf uninstall-plugin kibana-me-logs; go get ./...; cf install-plugin $GOPATH/bin/cf-plugin-kibana-me-logs && cf kibana-me-logs
```
### Bump version & release
There is a helper script to bump the version number `VERSION` file and regenerate the gobindata `version.go` file:
```
export VERSION=X.Y.Z
./bin/bump_version.sh $VERSION
git commit -a -m "bump v$VERSION"
git push
./bin/build.sh
./bin/release.sh
./bin/plugin_index.sh
```
Put the output from `plugin_index.sh` into the
[cloudfoundry-incubator/cli-plugin-repo][1] repository and
submit a pull request to update http://plugins.cloudfoundry.org
[1]: https://github.com/cloudfoundry-incubator/cli-plugin-repo