diff --git a/buildscripts/semantic-convention/templates/SemanticAttributes.java.j2 b/buildscripts/semantic-convention/templates/SemanticAttributes.java.j2
index 5051cd3d742..e0c5135515f 100644
--- a/buildscripts/semantic-convention/templates/SemanticAttributes.java.j2
+++ b/buildscripts/semantic-convention/templates/SemanticAttributes.java.j2
@@ -166,13 +166,13 @@ public final class {{class}} {
   public static final AttributeKey<String> HTTP_HOST = stringKey("http.host");
 
   /**
-   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions.
+   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions. Please use {@link SemanticAttributes#NET_SOCK_PEER_ADDR} instead.
    */
   @Deprecated
   public static final AttributeKey<String> NET_PEER_IP = stringKey("net.peer.ip");
 
   /**
-   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions.
+   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions. Please use {@link SemanticAttributes#NET_SOCK_HOST_ADDR} instead.
    */
   @Deprecated
   public static final AttributeKey<String> NET_HOST_IP = stringKey("net.host.ip");
diff --git a/semconv/src/main/java/io/opentelemetry/semconv/trace/attributes/SemanticAttributes.java b/semconv/src/main/java/io/opentelemetry/semconv/trace/attributes/SemanticAttributes.java
index 8bc72516772..d3287d37091 100644
--- a/semconv/src/main/java/io/opentelemetry/semconv/trace/attributes/SemanticAttributes.java
+++ b/semconv/src/main/java/io/opentelemetry/semconv/trace/attributes/SemanticAttributes.java
@@ -1414,12 +1414,14 @@ private MessageTypeValues() {}
   @Deprecated public static final AttributeKey<String> HTTP_HOST = stringKey("http.host");
 
   /**
-   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions.
+   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions. Please use
+   *     {@link SemanticAttributes#NET_SOCK_PEER_ADDR} instead.
    */
   @Deprecated public static final AttributeKey<String> NET_PEER_IP = stringKey("net.peer.ip");
 
   /**
-   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions.
+   * @deprecated This item has been removed as of 1.13.0 of the semantic conventions. Please use
+   *     {@link SemanticAttributes#NET_SOCK_HOST_ADDR} instead.
    */
   @Deprecated public static final AttributeKey<String> NET_HOST_IP = stringKey("net.host.ip");