add docker event receiver

[evanzhang87]

Component(s)

No response

Is your feature request related to a problem? Please describe.

I want to get container events

Describe the solution you'd like

I'd like to subscribe some docker event, such as container create/stop oom

Describe alternatives you've considered

New a docker client, and subscribe docker event

client, _ := docker.NewClientWithOpts(docker.WithHost(opt.Endpoint), docker.WithVersion(version))
msgC, _ := client.Events(context.TODO(), types.EventsOptions{})

for event := range msgC {
// TODO
}

Additional context

No response

[atoulme]

Please look at https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/receiver/dockerstatsreceiver
What do you want to do with those events? Treat them as logs? Traces? Metrics? If logs, what format would they take?

[evanzhang87]

What do you want to do with those events?

I want to know about when these events happened, I will make a statistics on how many containers are created or destroyed, or send a alert about oom event.

what format would they take?

It should be treated as log, for I need to know the container name or some other meta infomation like hostname, ip, etc. It may cause High Cardinality problem if I use metrics. And the meaning of the event is also closer to the log, so it' better to be treated as log I think.

[github-actions]

Pinging code owners for receiver/dockerstats: @rmfitzpatrick @jamesmoessis. See Adding Labels via Comments if you do not have permissions to add labels yourself.

[atoulme]

Pinging dockerstats receiver codeowners in case they have an idea on the best path here.

[rmfitzpatrick]

I think this would be useful functionality to add to the docker stats receiver as a logs receiver. Its core docker client already watches for a subset of container events in determining from which ones to pull stats. Since the OTel notion of events is in development but has effectively been formalized to use log records, it's possible that we'd be able to collaborate on future semantic conventions for the platform.

https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/logs/event-api.md
https://github.com/open-telemetry/semantic-conventions/blob/main/docs/general/events.md

[crobert-1]

Removing needs triage based on @rmfitzpatrick's (code owner of the dockerstats receiver) comments. This issue can be considered an enhancement request to add log support to the receiver.

[github-actions]

This issue has been inactive for 60 days. It will be closed in 60 days if there is no activity. To ping code owners by adding a component label, see Adding Labels via Comments, or if you are unsure of which component this issue relates to, please ping @open-telemetry/collector-contrib-triagers. If this issue is still relevant, please ping the code owners or leave a comment explaining why it is still relevant. Otherwise, please close it.

Pinging code owners:

• receiver/dockerstats: @rmfitzpatrick @jamesmoessis

See Adding Labels via Comments if you do not have permissions to add labels yourself.

[github-actions]

This issue has been inactive for 60 days. It will be closed in 60 days if there is no activity. To ping code owners by adding a component label, see Adding Labels via Comments, or if you are unsure of which component this issue relates to, please ping @open-telemetry/collector-contrib-triagers. If this issue is still relevant, please ping the code owners or leave a comment explaining why it is still relevant. Otherwise, please close it.

Pinging code owners:

• receiver/dockerstats: @rmfitzpatrick @jamesmoessis

See Adding Labels via Comments if you do not have permissions to add labels yourself.

[github-actions]

This issue has been inactive for 60 days. It will be closed in 60 days if there is no activity. To ping code owners by adding a component label, see Adding Labels via Comments, or if you are unsure of which component this issue relates to, please ping @open-telemetry/collector-contrib-triagers. If this issue is still relevant, please ping the code owners or leave a comment explaining why it is still relevant. Otherwise, please close it.

Pinging code owners:

• receiver/dockerstats: @rmfitzpatrick @jamesmoessis

See Adding Labels via Comments if you do not have permissions to add labels yourself.