introduce event semantic conventions

buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2

@@ -0,0 +1,30 @@
+{%- set my_class_name = ctx.root_namespace | pascal_case ~ "IncubatingEvents" -%}
+
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class {{ my_class_name }} {
+  {%- for event in ctx.events -%}
+    {%- if event is deprecated -%}
+      {%- if event.deprecated.note == "Uncategorized." -%}
+        {%- set deprecated_javadoc = "@deprecated" -%}
+      {%- else -%}
+        {%- set deprecated_javadoc = "@deprecated " ~ event.deprecated.note -%}
+      {%- endif -%}
+    {%- else -%}
+      {%- set deprecated_javadoc = "" -%}
+    {%- endif -%}
+    {{ [event.brief, concat_if("\n\nNotes:\n\n", event.note), deprecated_javadoc] | comment }}
+    {%- if event is deprecated -%}
+      @Deprecated
+    {%- endif %}
+    public static final String {{ event.name | screaming_snake_case }} = "{{ event.name }}";
+  {%- endfor %}
+
+  private {{ my_class_name }}() {}
+}

buildscripts/templates/registry/incubating_java/weaver.yaml

@@ -27,6 +27,18 @@ templates:
       })
     application_mode: each
     file_name: "{{ctx.root_namespace | pascal_case}}IncubatingAttributes.java"
+  - pattern: IncubatingSemanticEvents.java.j2
+    filter: >
+      semconv_signal("event"; {
+        "exclude_root_namespace": $excluded_namespaces
+      })
+      | group_by(.root_namespace)
+      | map({
+          root_namespace: .[0].root_namespace,
+          events: sort_by(.name)
+        })
+    application_mode: each
+    file_name: "{{ctx.root_namespace | pascal_case}}IncubatingEvents.java"
 text_maps:
   java_enum_type:
     int: long
@@ -73,4 +85,3 @@ text_maps:
     int[]: longArrayKeyTemplate
     double[]: doubleArrayKeyTemplate
     boolean[]: booleanArrayKeyTemplate
-

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AppIncubatingEvents.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class AppIncubatingEvents {
+  /**
+   * This event indicates that the application has detected substandard UI rendering performance.
+   *
+   * <p>Notes:
+   *
+   * <p>Jank happens when the UI is rendered slowly enough for the user to experience some
+   * disruption or sluggishness.
+   */
+  public static final String APP_JANK = "app.jank";
+
+  /**
+   * This event represents an instantaneous click on the screen of an application.
+   *
+   * <p>Notes:
+   *
+   * <p>The {@code app.screen.click} event can be used to indicate that a user has clicked or tapped
+   * on the screen portion of an application. Clicks outside of an application's active area SHOULD
+   * NOT generate this event. This event does not differentiate between touch/mouse down and
+   * touch/mouse up. Implementations SHOULD give preference to generating this event at the time the
+   * click is complete, typically on touch release or mouse up. The location of the click event MUST
+   * be provided in absolute screen pixels.
+   */
+  public static final String APP_SCREEN_CLICK = "app.screen.click";
+
+  /**
+   * This event indicates that an application widget has been clicked.
+   *
+   * <p>Notes:
+   *
+   * <p>Use this event to indicate that visual application component has been clicked, typically
+   * through a user's manual interaction.
+   */
+  public static final String APP_WIDGET_CLICK = "app.widget.click";
+
+  private AppIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AzIncubatingEvents.java

@@ -0,0 +1,20 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class AzIncubatingEvents {
+  /**
+   * Deprecated. Use {@code azure.resource.log} instead.
+   *
+   * @deprecated Replaced by {@code azure.resource.log}.
+   */
+  @Deprecated public static final String AZ_RESOURCE_LOG = "az.resource.log";
+
+  private AzIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AzureIncubatingEvents.java

@@ -0,0 +1,20 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class AzureIncubatingEvents {
+  /**
+   * Describes Azure Resource Log event, see <a
+   * href="https://learn.microsoft.com/azure/azure-monitor/essentials/resource-logs-schema#top-level-common-schema">Azure
+   * Resource Log Top-level Schema</a> for more details.
+   */
+  public static final String AZURE_RESOURCE_LOG = "azure.resource.log";
+
+  private AzureIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/BrowserIncubatingEvents.java

@@ -0,0 +1,19 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class BrowserIncubatingEvents {
+  /**
+   * This event describes the website performance metrics introduced by Google, See <a
+   * href="https://web.dev/vitals">web vitals</a>.
+   */
+  public static final String BROWSER_WEB_VITAL = "browser.web_vital";
+
+  private BrowserIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DbIncubatingEvents.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class DbIncubatingEvents {
+  /**
+   * This event represents an exception that occurred during a database client operation, such as
+   * connection failures, query errors, timeouts, or other errors that prevent the operation from
+   * completing successfully.
+   *
+   * <p>Notes:
+   *
+   * <p>This event SHOULD be recorded when an exception occurs during database client operations.
+   * Instrumentations SHOULD set the severity to WARN (severity number 13) when recording this
+   * event. Instrumentations MAY provide a configuration option to populate exception events with
+   * the attributes captured on the corresponding database client span.
+   */
+  public static final String DB_CLIENT_OPERATION_EXCEPTION = "db.client.operation.exception";
+
+  private DbIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DeviceIncubatingEvents.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class DeviceIncubatingEvents {
+  /**
+   * This event represents an occurrence of a lifecycle transition on Android or iOS platform.
+   *
+   * <p>Notes:
+   *
+   * <p>The event body fields MUST be used to describe the state of the application at the time of
+   * the event. This event is meant to be used in conjunction with {@code os.name} <a
+   * href="/docs/resource/os.md">resource semantic convention</a> to identify the mobile operating
+   * system (e.g. Android, iOS). The {@code android.app.state} and {@code ios.app.state} fields are
+   * mutually exclusive and MUST NOT be used together, each field MUST be used with its
+   * corresponding {@code os.name} value.
+   */
+  public static final String DEVICE_APP_LIFECYCLE = "device.app.lifecycle";
+
+  private DeviceIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ExceptionIncubatingEvents.java

@@ -0,0 +1,16 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class ExceptionIncubatingEvents {
+  /** This event describes a single exception. */
+  public static final String EXCEPTION = "exception";
+
+  private ExceptionIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/FaasIncubatingEvents.java

@@ -0,0 +1,27 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class FaasIncubatingEvents {
+  /**
+   * This event represents an exception that occurred during FaaS function invocation, such as
+   * application errors, internal failures, or other exceptions that prevent the function from
+   * completing successfully.
+   *
+   * <p>Notes:
+   *
+   * <p>This event SHOULD be recorded when an exception occurs during FaaS function invocation.
+   * Instrumentations SHOULD set the severity to ERROR (severity number 17) when recording this
+   * event. Instrumentations MAY provide a configuration option to populate exception events with
+   * the attributes captured on the corresponding FaaS span.
+   */
+  public static final String FAAS_INVOCATION_EXCEPTION = "faas.invocation.exception";
+
+  private FaasIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/FeatureFlagIncubatingEvents.java

@@ -0,0 +1,26 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class FeatureFlagIncubatingEvents {
+  /**
+   * Defines feature flag evaluation as an event.
+   *
+   * <p>Notes:
+   *
+   * <p>A {@code feature_flag.evaluation} event SHOULD be emitted whenever a feature flag value is
+   * evaluated, which may happen many times over the course of an application lifecycle. For
+   * example, a website A/B testing different animations may evaluate a flag each time a button is
+   * clicked. A {@code feature_flag.evaluation} event is emitted on each evaluation even if the
+   * result is the same.
+   */
+  public static final String FEATURE_FLAG_EVALUATION = "feature_flag.evaluation";
+
+  private FeatureFlagIncubatingEvents() {}
+}

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/GenAiIncubatingEvents.java

@@ -0,0 +1,86 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.semconv.incubating;
+
+// DO NOT EDIT, this is an Auto-generated file from
+// buildscripts/templates/registry/incubating_java/IncubatingSemanticEvents.java.j2
+@SuppressWarnings("unused")
+public final class GenAiIncubatingEvents {
+  /**
+   * This event describes the assistant message passed to GenAI system.
+   *
+   * @deprecated Chat history is reported on {@code gen_ai.input.messages} attribute on spans or
+   *     {@code gen_ai.client.inference.operation.details} event.
+   */
+  @Deprecated public static final String GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+
+  /**
+   * This event describes the Gen AI response message.
+   *
+   * @deprecated Chat history is reported on {@code gen_ai.output.messages} attribute on spans or
+   *     {@code gen_ai.client.inference.operation.details} event.
+   */
+  @Deprecated public static final String GEN_AI_CHOICE = "gen_ai.choice";
+
+  /**
+   * Describes the details of a GenAI completion request including chat history and parameters.
+   *
+   * <p>Notes:
+   *
+   * <p>This event is opt-in and could be used to store input and output details independently from
+   * traces.
+   */
+  public static final String GEN_AI_CLIENT_INFERENCE_OPERATION_DETAILS =
+      "gen_ai.client.inference.operation.details";
+
+  /**
+   * This event represents an exception that occurred during a Generative AI client operation, such
+   * as API errors, rate limiting, model errors, timeouts, or other errors that prevent the
+   * operation from completing successfully.
+   *
+   * <p>Notes:
+   *
+   * <p>This event SHOULD be recorded when an exception occurs during Generative AI client
+   * operations. Instrumentations SHOULD set the severity to WARN (severity number 13) when
+   * recording this event. Instrumentations MAY provide a configuration option to populate exception
+   * events with the attributes captured on the corresponding Generative AI client span.
+   */
+  public static final String GEN_AI_CLIENT_OPERATION_EXCEPTION =
+      "gen_ai.client.operation.exception";
+
+  /**
+   * This event captures the result of evaluating GenAI output for quality, accuracy, or other
+   * characteristics. This event SHOULD be parented to GenAI operation span being evaluated when
+   * possible or set {@code gen_ai.response.id} when span id is not available.
+   */
+  public static final String GEN_AI_EVALUATION_RESULT = "gen_ai.evaluation.result";
+
+  /**
+   * This event describes the system instructions passed to the GenAI model.
+   *
+   * @deprecated Chat history is reported on {@code gen_ai.system_instructions} attribute on spans
+   *     or {@code gen_ai.client.inference.operation.details} event.
+   */
+  @Deprecated public static final String GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+
+  /**
+   * This event describes the response from a tool or function call passed to the GenAI model.
+   *
+   * @deprecated Chat history is reported on {@code gen_ai.input.messages} attribute on spans or
+   *     {@code gen_ai.client.inference.operation.details} event.
+   */
+  @Deprecated public static final String GEN_AI_TOOL_MESSAGE = "gen_ai.tool.message";
+
+  /**
+   * This event describes the user message passed to the GenAI model.
+   *
+   * @deprecated Chat history is reported on {@code gen_ai.input.messages} attribute on spans or
+   *     {@code gen_ai.client.inference.operation.details} event.
+   */
+  @Deprecated public static final String GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+
+  private GenAiIncubatingEvents() {}
+}