[receiver/k8sobjects] Support running in kubernetes leader election mode.

[JaredTan95]

Description: add leader election func to support otel col running in kubernetes leader election mode

BTW, as @dmitryax #17369 (comment), this feature also works for k8scluster, k8sevents receivers, so put this function as an internal method.

Link to tracking Issue: #17369, #32994

Testing:

1. deploy otel col in 3 replicas, and configuraed k8sobjectsreceiver to watch kubernetes event logs as follows yaml:

apiVersion: v1
kind: ServiceAccount
metadata:
  namespace: default
  name: otel-event-receiver-lr
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: otel-event-receiver-lr
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: otel-event-receiver-lr
subjects:
  - kind: ServiceAccount
    name: otel-event-receiver-lr
    namespace: default
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: otel-event-receiver-lr
rules:
- apiGroups:
  - coordination.k8s.io
  resources:
  - leases
  verbs:
  - create
  - get
  - update
- apiGroups:
  - ""
  resources:
  - events
  - pods
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - "events.k8s.io"
  resources:
  - events
  verbs:
  - watch
  - list
---
apiVersion: opentelemetry.io/v1alpha1
kind: OpenTelemetryCollector
metadata:
  name: otel-event-receiver-collector
spec:
  replicas: 3
  mode: deployment # This configuration is omittable.
  image: wutang/otelcontribcol:lr-0831 # my onw image build By PR changes.
  serviceAccount: otel-event-receiver-lr
  config: |
    receivers:
      k8sobjects:
        leader_election:
          enabled: true
          lock_name: otel-event-receiver-lr
        auth_type: serviceAccount
        objects:
          - name: events
            mode: watch
            group: events.k8s.io

    exporters:
      logging:
        verbosity: detailed

    service:
      pipelines:
        logs:
          receivers: [k8sobjects]
          exporters: [logging]

2. check 3 replica pod's logs, there is always one pod in working and watch event lgos:

Documentation:

[JaredTan95]

@jpkrohling @dmitryax hi, do you have time to help review this PR?

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 14 days.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 14 days.

[jpkrohling]

What's the state of this PR?

[JaredTan95]

What's the state of this PR?

finding a way to add Unit-test...

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 14 days.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 14 days.

[github-actions]

This PR was marked stale due to lack of activity. It will be closed in 14 days.

[github-actions]

Closed as inactive. Feel free to reopen if this PR is still being worked on.