[k8sattributes] rename internal telemetry (open-telemetry#45940)

<!--Ex. Fixing a bug - Describe the bug and how this fixes the issue.
Ex. Adding a feature - Explain what this achieves.-->
#### Description

This PR applies the renaming of the internal telemetry metrics in order
to use dots instead of underscores in alignment with
open-telemetry/opentelemetry-collector#12909
and OTel SemConv.

This will happen through a feature gate pair:
- `processor.k8sattributes.telemetry.disableOldFormatMetrics`
- `processor.k8sattributes.telemetry.enableNewFormatMetrics`

My suggestion will be to keep these gates in alpha for 3 releases, then
promote them to beta for another 3 before making them stable.

The renames are the following:

```
otelsvc_k8s_daemonset_added -> otelcol.k8s.watcher.daemonset.added
otelsvc_k8s_daemonset_deleted -> otelcol.k8s.watcher.daemonset.deleted
otelsvc_k8s_daemonset_updated -> otelcol.k8s.watcher.daemonset.updated
otelsvc_k8s_deployment_added -> otelcol.k8s.watcher.deployment.added
otelsvc_k8s_deployment_deleted -> otelcol.k8s.watcher.deployment.deleted
otelsvc_k8s_deployment_updated -> otelcol.k8s.watcher.deployment.updated
otelsvc_k8s_job_added -> otelcol.k8s.watcher.job.added
otelsvc_k8s_job_deleted -> otelcol.k8s.watcher.job.deleted
otelsvc_k8s_job_updated -> otelcol.k8s.watcher.job.updated
otelsvc_k8s_namespace_added -> otelcol.k8s.watcher.namespace.added
otelsvc_k8s_namespace_deleted -> otelcol.k8s.watcher.namespace.deleted
otelsvc_k8s_namespace_updated -> otelcol.k8s.watcher.namespace.updated
otelsvc_k8s_node_added -> otelcol.k8s.watcher.node.added
otelsvc_k8s_node_deleted -> otelcol.k8s.watcher.node.deleted
otelsvc_k8s_node_updated -> otelcol.k8s.watcher.node.updated
otelsvc_k8s_pod_added -> otelcol.k8s.watcher.pod.added
otelsvc_k8s_pod_deleted -> otelcol.k8s.watcher.pod.deleted
otelsvc_k8s_pod_updated -> otelcol.k8s.watcher.pod.updated
otelsvc_k8s_pod_table_size -> otelcol.k8s.watcher.pod_cache.size
otelsvc_k8s_replicaset_added -> otelcol.k8s.watcher.replicaset.added
otelsvc_k8s_replicaset_deleted -> otelcol.k8s.watcher.replicaset.deleted
otelsvc_k8s_replicaset_updated -> otelcol.k8s.watcher.replicaset.updated
otelsvc_k8s_statefulset_added -> otelcol.k8s.watcher.statefulset.added
otelsvc_k8s_statefulset_deleted -> otelcol.k8s.watcher.statefulset.deleted
otelsvc_k8s_statefulset_updated -> otelcol.k8s.watcher.statefulset.updated
```

`otelcol_otelsvc_k8s_ip_lookup_miss` -> [DEPRECATED] Number of times pod
by IP lookup failed

> **Deprecated since 0.146.0**
> Use otelcol.k8s.pod.association instead

<!-- Issue number (e.g. open-telemetry#1234) or full URL to issue, if applicable. -->
#### Link to tracking issue
Fixes
open-telemetry#45871

<!--Describe what testing was performed and which tests were added.-->
#### Testing
~

<!--Describe the documentation added.-->
#### Documentation
Updated

<!--Please delete paragraphs that you did not use before submitting.-->

Signed-off-by: ChrsMark <chrismarkou92@gmail.com>

Author: ChrsMark

.chloggen/k8sattr_rename_internal_telemetry.yaml

@@ -0,0 +1,27 @@
+# Use this changelog template to create an entry for release notes.
+
+# One of 'breaking', 'deprecation', 'new_component', 'enhancement', 'bug_fix'
+change_type: deprecation
+
+# The name of the component, or a single word describing the area of concern, (e.g. receiver/filelog)
+component: processor/k8s_attributes
+
+# A brief description of the change.  Surround your text with quotes ("") if it needs to start with a backtick (`).
+note: Rename internal telemetry metrics to use dots instead of underscores
+
+# Mandatory: One or more tracking issues related to the change. You can use the PR number here if no issue exists.
+issues: [45871]
+
+# (Optional) One or more lines of additional information to render under the primary note.
+# These lines will be padded with 2 spaces and then inserted directly into the document.
+# Use pipe (|) for multiline entries.
+subtext:
+
+# If your change doesn't affect end users or the exported elements of any package,
+# you should instead start your pull request title with [chore] or use the "Skip Changelog" label.
+# Optional: The change log or logs in which this entry should be included.
+# e.g. '[user]' or '[user, api]'
+# Include 'user' if the change is relevant to end users.
+# Include 'api' if there is a change to a library API.
+# Default: '[user]'
+change_logs: [user]

processor/k8sattributesprocessor/documentation.md

@@ -42,14 +42,171 @@
 
 The following telemetry is emitted by this component.
 
-### otelcol_otelsvc_k8s_ip_lookup_miss
+### otelcol.k8s.watcher.job.added
 
-Number of times pod by IP lookup failed.
+Number of job add events received
 
 | Unit | Metric Type | Value Type | Monotonic | Stability |
 | ---- | ----------- | ---------- | --------- | --------- |
 | 1 | Sum | Int | true | Development |
 
+### otelcol.k8s.watcher.job.deleted
+
+Number of job delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.job.updated
+
+Number of job update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.namespace.added
+
+Number of namespace add events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.namespace.deleted
+
+Number of namespace delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.namespace.updated
+
+Number of namespace update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.node.added
+
+Number of node add events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.node.deleted
+
+Number of node delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.node.updated
+
+Number of node update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.pod.added
+
+Number of pod add events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.pod.deleted
+
+Number of pod delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.pod.updated
+
+Number of pod update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.pod_cache.size
+
+Size of cache table containing pod info
+
+| Unit | Metric Type | Value Type | Stability |
+| ---- | ----------- | ---------- | --------- |
+| 1 | Gauge | Int | Development |
+
+### otelcol.k8s.watcher.replicaset.added
+
+Number of ReplicaSet add events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.replicaset.deleted
+
+Number of ReplicaSet delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.replicaset.updated
+
+Number of ReplicaSet update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.statefulset.added
+
+Number of statefulset add events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.statefulset.deleted
+
+Number of statefulset delete events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol.k8s.watcher.statefulset.updated
+
+Number of statefulset update events received
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Development |
+
+### otelcol_otelsvc_k8s_ip_lookup_miss
+
+[DEPRECATED] Number of times pod by IP lookup failed
+
+> **Deprecated since 0.146.0**
+> Use otelcol.k8s.pod.association instead
+
+| Unit | Metric Type | Value Type | Monotonic | Stability |
+| ---- | ----------- | ---------- | --------- | --------- |
+| 1 | Sum | Int | true | Deprecated since 0.146.0 |
+
+**Deprecation note**: Use otelcol.k8s.pod.association instead
+
 ### otelcol_otelsvc_k8s_namespace_added
 
 Number of namespace add events received
@@ -163,5 +320,7 @@ This component has the following feature gates:
 | `k8sattr.labelsAnnotationsSingular.allow` | deprecated | When enabled, default k8s label and annotation resource attribute keys will be singular, instead of plural | v0.125.0 | v0.145.0 | [Link](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/39774) |
 | `processor.k8sattributes.DontEmitV0K8sConventions` | alpha | When enabled, semconv legacy attributes are disabled. | v0.145.0 | N/A | [Link](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/44589) |
 | `processor.k8sattributes.EmitV1K8sConventions` | alpha | When enabled, semconv stable attributes are enabled. | v0.145.0 | N/A | [Link](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/44589) |
+| `processor.k8sattributes.telemetry.disableOldFormatMetrics` | alpha | When enabled, old formatted internal telemetry metrics are disabled. | v0.146.0 | N/A | [Link](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/45871) |
+| `processor.k8sattributes.telemetry.enableNewFormatMetrics` | alpha | When enabled, new formatted internal telemetry metrics are enabled. | v0.146.0 | N/A | [Link](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/45871) |
 
 For more information about feature gates, see the [Feature Gates](https://github.com/open-telemetry/opentelemetry-collector/blob/main/featuregate/README.md) documentation.