Skip to content

added logentries driver#22699

Closed
caarlos0 wants to merge 2 commits intomoby:masterfrom
caarlos0:logentries
Closed

added logentries driver#22699
caarlos0 wants to merge 2 commits intomoby:masterfrom
caarlos0:logentries

Conversation

@caarlos0
Copy link
Contributor

@caarlos0 caarlos0 commented May 12, 2016

Add logentries log driver.

I used the logentries documentation and based my change uppon other log drivers implementations.

I'm not sure how to test this alone, this is my first contribution to docker as developer, so, any tips on this will be appreciated (a way to build and test only the logger will be awesome 👍 ).

@GordonTheTurtle GordonTheTurtle added status/0-triage dco/no Automatically set by a bot when one of the commits lacks proper signature labels May 12, 2016
@caarlos0
Copy link
Contributor Author

caarlos0 commented May 12, 2016

@GordonTheTurtle my commit is signed already :(

@cpuguy83
Copy link
Member

@caarlos0 I don't see a signature in your commit.

@GordonTheTurtle GordonTheTurtle removed the dco/no Automatically set by a bot when one of the commits lacks proper signature label May 12, 2016
@thaJeztah
Copy link
Member

my commit is signed, don't know why it is complaining about it

You signed it with GPG, but it needs a "signed-off-by .." in the commit message (docker commit -s). I usually do docker commit -s -S

@GordonTheTurtle GordonTheTurtle removed the dco/no Automatically set by a bot when one of the commits lacks proper signature label May 12, 2016
@caarlos0
Copy link
Contributor Author

@thaJeztah ohh, got it, fixed. Thanks =)

@StephenHynes7
Copy link

From a Logentries perspective everything looks fine, bsphere's lib is reliable and has been for a very long time. The only caveat though is that the logs do not send over SSL which is a bit sad tbh :(

@caarlos0
Copy link
Contributor Author

@StephenHynes7 Yeah :(

@caarlos0
Copy link
Contributor Author

@StephenHynes7 any lib that supports SSL?

@thaJeztah
Copy link
Member

I'm not too familiar with logentries.com, @cpuguy83 told me it also implements syslog, so would there be downsides to using syslog instead of this driver?

Basically, we want to limit the amount of new logging drivers, and prefer to only add ones that are really necessary (until we have a system in place to allow external logging drives)

@caarlos0
Copy link
Contributor Author

@thaJeztah It would require to have syslog installed, configured and running on the docker host...

I guess having the log driver in docker itself gives more power because the user can send logs to different accounts in different containers, etc...

@StephenHynes7
Copy link

StephenHynes7 commented May 13, 2016

@caarlos0 > any lib that supports SSL?

There is but I think the GO library is worth going forward with, I will look to see if I can create a PR for SSL option for it and we can see what happens.

@caarlos0
Copy link
Contributor Author

@StephenHynes7 nice! Thanks

@StephenHynes7
Copy link

@caarlos0 fyi I have a PR to add tls support for the log library once that is merged then I would be happy here.

@caarlos0
Copy link
Contributor Author

@StephenHynes7 Nice, I'll take a look!

@StephenHynes7
Copy link

Okay so now this driver will send logs over TLS so as far as Logentries is concerned we are good 👍

@caarlos0
Copy link
Contributor Author

@StephenHynes7 I'll update the submodule here

@GordonTheTurtle GordonTheTurtle added dco/no Automatically set by a bot when one of the commits lacks proper signature and removed dco/no Automatically set by a bot when one of the commits lacks proper signature labels May 18, 2016
@icecrime icecrime added the status/failing-ci Indicates that the PR in its current state fails the test suite label May 18, 2016
@thaJeztah
Copy link
Member

@caarlos0 can you check the "vendor" failure to see if it's genuine? Looks like the vendor-check found a difference between the actually vendored files and the ones it's expecting;

13:38:39 The result of ./hack/vendor.sh differs
13:38:39 
13:38:39  D vendor/src/github.com/bsphere/le_go/.gitignore
13:38:39  D vendor/src/github.com/bsphere/le_go/.travis.yml
13:38:39  D vendor/src/github.com/bsphere/le_go/README.md
13:38:39  D vendor/src/github.com/bsphere/le_go/certs.go
13:38:39  D vendor/src/github.com/bsphere/le_go/le.go
13:38:39  D vendor/src/github.com/bsphere/le_go/le_test.go

@caarlos0
Copy link
Contributor Author

@thaJeztah yeah, I need some help on that I guess..

I cloned the module inside the vendor folder and removed the .git folder, then added it to the hack/vendor.sh

Is that the correct way of doing this?

@thaJeztah
Copy link
Member

Basically, you usually edit the script, then run it. This may take a while though (and I'm not sure it works correctly if you're running on OS X); alternatively you can fix by adding/removing the files mentioned above :-)

@caarlos0
Copy link
Contributor Author

@thaJeztah If I run the script, basically all vendors change... don't know why.

I'll try to comment the others and leave only le_go and then run it.

@cpuguy83
Copy link
Member

cpuguy83 commented Sep 8, 2016

Definitely no problem with adding this driver. Library is clean and super tiny, but we really need to follow good practices and not embed the certificate in docker's code base.

@caarlos0
Copy link
Contributor Author

caarlos0 commented Sep 8, 2016

I just opened a PR removing the certificates from the le_go lib: bsphere/le_go#12

@caarlos0
Copy link
Contributor Author

caarlos0 commented Sep 8, 2016

@cpuguy83 Updated the le_go submodule, vendored and rebased commits with master.

@cpuguy83
Copy link
Member

cpuguy83 commented Sep 8, 2016

LGTM

@cpuguy83
Copy link
Member

cpuguy83 commented Sep 8, 2016

Oh except vendor is not quite right:

19:04:42 The result of ./hack/vendor.sh differs
19:04:42 
19:04:42  D vendor/src/github.com/bsphere/le_go/le_test.go
19:04:42 
19:04:42 Please vendor your package with ./hack/vendor.sh.

@caarlos0
Copy link
Contributor Author

caarlos0 commented Sep 8, 2016

@cpuguy83 oops

@caarlos0
Copy link
Contributor Author

caarlos0 commented Sep 8, 2016

@cpuguy83 should be good now

@cpuguy83
Copy link
Member

cpuguy83 commented Sep 9, 2016

re-LGTM.

@caarlos0
Copy link
Contributor Author

caarlos0 commented Oct 7, 2016

ping? (I just merged it again with master)

@GordonTheTurtle GordonTheTurtle added the dco/no Automatically set by a bot when one of the commits lacks proper signature label Oct 7, 2016
Signed-off-by: Carlos Alexandro Becker <[email protected]>
Signed-off-by: Carlos Alexandro Becker <[email protected]>
@GordonTheTurtle GordonTheTurtle removed the dco/no Automatically set by a bot when one of the commits lacks proper signature label Oct 7, 2016
@mlaventure
Copy link
Contributor

LGTM.

Moving to doc review.

re-ping @thaJeztah

Copy link
Member

@thaJeztah thaJeztah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this logging driver supports viewing logs through docker logs (correct?) in that case no changes are needed in the reference docs. The documentation in this PR should go into the central docs repository though (see my comment).

Also, we need some changes in the bash and zsh completion scripts; https://github.com/docker/docker/blob/f08a450ad35706900766e7766d30a90d688e410b/contrib/completion/bash/docker#L499-L561 https://github.com/docker/docker/blob/6b997739fe5f4de411ccf30be574ee11a2780018/contrib/completion/zsh/_docker#L217-L251

Let us know if you want to try making those changes, or rather leave that to @albers and @sdurrheimer (who maintain those scripts)

+++
<![end-metadata]-->

# Logentries logging driver
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This document was moved to the central docs repository. Given that will be part of 1.13, and should not be published yet, can you remove this file here, and open a PR against the vnext-engine branch in that repository?

https://github.com/docker/docker.github.io/tree/vnext-engine/engine/admin/logging

@caarlos0
Copy link
Contributor Author

@thaJeztah

Seems like I deleted my fork and github lost track of the PR.

I tried re-create the fork and the branch from the pull request ref (refs/pull/22699/head) and push it again, but it doesn't seem to be working.

Should I open another pr?

@thaJeztah
Copy link
Member

@caarlos0 yes, probably not possible to update the PR if you had to create a new branch. Let me know when it's up then we can link to it, and close this one

@caarlos0
Copy link
Contributor Author

@thaJeztah I just created a PR for the docs in docker/docs#244

@caarlos0
Copy link
Contributor Author

@thaJeztah #27471. Can I close this one?

@thaJeztah
Copy link
Member

Yes, let's close, thanks!

@thaJeztah thaJeztah closed this Oct 18, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants