|
| 1 | +Retrieving Cloudflare logs via [Logpull API][logpull], and pushing them |
| 2 | +into Elasticsearch with [Filebeat][filebeat]. |
| 3 | + |
| 4 | + |
| 5 | +## Local Development |
| 6 | + |
| 7 | +### Build |
| 8 | + |
| 9 | +```sh |
| 10 | +docker build -t get-logs . |
| 11 | +``` |
| 12 | + |
| 13 | +### Launch |
| 14 | + |
| 15 | +> Before launching, make sure to set your CF credentials as environment variables |
| 16 | +> ``` |
| 17 | +> export CF_ZONE_ID=51e241f08e014feb95d1b2760228d12a |
| 18 | + |
| 19 | +> export CF_AUTH_KEY=51e241f08e014feb95d1b2760228d12a2df50 |
| 20 | +> ``` |
| 21 | +> or modify [`docker-compose.yaml`][docker-compose.yaml] appropriately (see docs on [`env_file`][compose-env-file], and [`environment`][compose-environment] usage) |
| 22 | +
|
| 23 | +After launching local environment, access Kibana via http://localhost:5601/app/kibana#/discover. |
| 24 | +
|
| 25 | +
|
| 26 | +#### With Docker Compose |
| 27 | +
|
| 28 | +```sh |
| 29 | +# launch Elasticsearch, Kibana, and get-logs container instances |
| 30 | +docker-compose up -d |
| 31 | +
|
| 32 | +# keep an eye on the logs |
| 33 | +docker-compose logs -f get-logs |
| 34 | +``` |
| 35 | +
|
| 36 | +#### Launch manually |
| 37 | + |
| 38 | +```sh |
| 39 | +# launch Elasticsearch container instance |
| 40 | +docker run -d \ |
| 41 | + --name es \ |
| 42 | + -p 9200:9200 \ |
| 43 | + -e "discovery.type=single-node" \ |
| 44 | + docker.elastic.co/elasticsearch/elasticsearch:7.6.2 |
| 45 | + |
| 46 | +# launch Kibana container instance |
| 47 | +docker run -d \ |
| 48 | + --name ki \ |
| 49 | + -p 5601:5601 \ |
| 50 | + --link es:elasticsearch \ |
| 51 | + docker.elastic.co/kibana/kibana:7.6.2 |
| 52 | + |
| 53 | +# launch Cloudflare Logpull container instance |
| 54 | +docker run -it --rm \ |
| 55 | + -e CF_AUTH_EMAIL \ |
| 56 | + -e CF_AUTH_KEY \ |
| 57 | + -e CF_ZONE_ID \ |
| 58 | + -e SAMPLE_RATE="0.01" \ |
| 59 | + -e ES_HOST="http://elasticsearch:9200" \ |
| 60 | + -e ES_INDEX="cloudflare-test" \ |
| 61 | + -e ES_INDEX_SHARD=6 \ |
| 62 | + -e ES_INDEX_REPLICAS=0 \ |
| 63 | + -e ES_INDEX_REFRESH=10s \ |
| 64 | + --link es:elasticsearch \ |
| 65 | + get-logs |
| 66 | +``` |
| 67 | + |
| 68 | +[link reference]:: |
| 69 | +[logpull]: https://developers.cloudflare.com/logs/logpull-api/ |
| 70 | +[filebeat]: https://www.elastic.co/guide/en/beats/filebeat/master/filebeat-overview.html |
| 71 | +[compose-env-file]: https://docs.docker.com/compose/compose-file/#env_file |
| 72 | +[compose-environment]: https://docs.docker.com/compose/compose-file/#environment |
| 73 | +[docker-compose.yaml]: ./docker-compose.yaml |
0 commit comments