Update overview

Author: dominicbetts

articles/iot-operations/.openpublishing.redirection.iot-operations.json

@@ -515,9 +515,14 @@
             "redirect_url": "/azure/iot-operations/discover-manage-assets/howto-autodetect-opcua-assets-using-akri",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/iot-operations/discover-manage-assets/concept-akri-architecture.md",
+            "redirect_url": "/azure/iot-operations/discover-manage-assets/overview-akri",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/iot-operations/manage-devices-assets/concept-akri-architecture.md",
-            "redirect_url": "/azure/iot-operations/discover-manage-assets/concept-akri-architecture",
+            "redirect_url": "/azure/iot-operations/discover-manage-assets/overview-akri",
             "redirect_document_id": false
         },
         {

articles/iot-operations/discover-manage-assets/concept-akri-architecture.md

@@ -1,22 +1,22 @@
 ---
-title: Detect assets with the Akri services
-description: Understand how the Akri services enable you to discover devices and assets at the edge, and expose them as resources on your cluster.
+title: Detect OPC UA assets (preview)
+description: Understand how the Akri services enable you to detect devices and assets at the edge, and expose them as resources on your cluster.
 author: dominicbetts
 ms.author: dobett
 ms.subservice: azure-akri
 ms.topic: overview
 ms.custom:
   - ignite-2023
-ms.date: 05/13/2024
+ms.date: 04/07/2025
 
-# CustomerIntent: As an industrial edge IT or operations user, I want to to understand how the Akri services enable me to discover devices and assets at the edge, and expose them as resources on a Kubernetes cluster.
+# CustomerIntent: As an industrial edge IT or operations user, I want to to understand how the Akri services enable me to detect devices and assets at the edge, and expose them as resources on a Kubernetes cluster.
 ---
 
-# What are the Akri services?
+# What is OPC UA asset detection (preview)?
 
-The Akri services host the discovery handlers that enable you to detect devices and assets at the edge, and expose them as resources on a Kubernetes cluster. Use the Akri services to simplify the process of projecting leaf devices such as OPC UA devices, cameras, IoT sensors, and peripherals into your cluster. The Akri services use the devices' own protocols to project leaf devices into your cluster. For administrators who attach or remove devices from a cluster, this capability reduces the amount of coordination and manual configuration required.
+Azure IoT Operations detects devices and assets by using the included Akri services (preview). The Akri services enable protocol connections and configurations by using Azure Device Registry. The Akri services simplify the process of projecting leaf devices such as OPC UA servers, cameras, IoT sensors, and other assets into the Azure Device Registry. The Akri services use the devices' own protocols to project leaf devices as Azure Resource Manager resources in the Azure Device Registry. For administrators who attach or remove devices from a cluster, this capability reduces the amount of coordination and manual configuration required.
 
-The Akri services are also extensible. You can use them as shipped, or you can add custom discovery and provisioning capabilities by adding protocol handlers, brokers, and behaviors.
+The Akri services are an extensible framework for all device protocols. You can use them with out-of-the-box and partner-built connectors, or you can add custom discovery and provisioning capabilities by adding protocol handlers, connectors, and behaviors. Adding custom logic is made easy with the [Azure IoT Operations SDK](https://github.com/azure/iot-operations-sdks) (preview).
 
 The Akri services are a Microsoft-managed commercial version of [Akri](https://docs.akri.sh/), an open-source Cloud Native Computing Foundation (CNCF) project.
 
@@ -53,25 +53,9 @@ With the Akri services, you can dynamically provision devices such as:
 
 The Akri services use standard Kubernetes primitives that let you apply your existing expertise and knowledge. Small devices connected to an Akri-configured cluster can appear as Kubernetes resources, just like memory or CPUs. The Akri services controller enables the cluster operator to start brokers, jobs, or other workloads for individual connected devices or groups of devices. These device configurations and properties remain in the cluster so that if there's node failure, other nodes can pick up any lost work.
 
-## Discover OPC UA assets
+## Detect OPC UA assets
 
-The Akri services are a turnkey solution that lets you discover and create assets connected to an OPC UA server at the edge. The Akri services discover devices at the edge and maps them to assets in your cluster. The assets send telemetry to upstream connectors. The Akri services let you eliminate the painstaking process of manually configuring and onboarding the assets to your cluster.
-
-## Key features
-
-The following list shows the key features of the Akri services:
-
-- **Dynamic discovery**. Protocol representations of devices can come and go, without static configurations in brokers or customer containers. To discover devices, the Akri services use the following methods:
-
-  - **Device network scanning**. This capability is useful for finding devices in smaller, remote locations such as a replacement camera in a store. The ONVIF and OPC UA localhost protocols currently support device network scanning discovery.
-  - **Device connecting**. This capability is typically used in larger industrial scenarios such as factory environments where the network is typically static and network scanning isn't permitted. The `udev` and OPC UA local discovery server protocols currently support device connecting discovery.
-  - **Device attach**. The Akri services also support custom logic for mapping or connecting devices. There are [open-source templates](https://docs.akri.sh/development/handler-development) to accelerate customization.
-
-- **Optimal scheduling**. The Akri services can schedule devices on specified nodes with minimal latency because it knows where particular devices are located on the Kubernetes cluster. Optimal scheduling applies to directly connected devices, or in scenarios where only specific nodes can access the devices.
-
-- **Optimal configuration**. The Akri services use the capacity of the node to drive cardinality of the brokers for the discovered devices.
-
-- **Secure credential management**. The Akri services facilitate secure access to assets and devices by integrating with services in the cluster that enable secure distribution of credential material to brokers.
+The Akri services and OPC UA connector are a turnkey solution that lets you detect assets connected to an OPC UA server and add the asset configurations into Azure Device Registry. The OPC UA connector detects assets at the edge and Akri services maps them to assets in Azure Device Registry. The assets send telemetry to upstream brokers and components. The Akri services let you eliminate the time-consuming and error-prone process of manually configuring and onboarding the assets to your cluster and Azure Device Registry.
 
 ### Features supported
 
@@ -89,19 +73,15 @@ The Akri services support the following features:
 | Akri services features   | Supported |
 |--------------------------|:---------:|
 | Installation through the Akri services Arc cluster extension |   ✅     |
-| Deployment through the orchestration service                 |   ✅     |
 | Onboard devices as custom resources to an edge cluster       |   ✅     |
-| View the Akri services metrics and logs through Azure Monitor |   ❌     |
+| View the Akri services metrics and logs through Azure Monitor |   ✅     |
+| The Akri services detect and create assets that can be ingested into the Azure Device Registry  |   ✅     |
 | Akri services configuration by using the operations experience web UI |   ❌     |
-| The Akri services detect and create assets that can be ingested into the Azure Device Registry  |   ❌     |
-| ISVs can build and sell custom protocol handlers for Azure IoT Operations solutions  |   ❌     |
+| Deployment and management features for integrating non-Microsoft or custom protocol connectors and discovery handlers |   ❌     |
 
 ## Related content
 
-To learn more about the Akri services, see:
-
-- [Akri services architecture](concept-akri-architecture.md)
-- [Discover OPC UA data sources using the Akri services](howto-autodetect-opcua-assets-using-akri.md)
+To learn more about the Akri services, see [Detect OPC UA data sources using the Akri services](howto-autodetect-opcua-assets-using-akri.md)
 
 To learn more about the open-source CNCF Akri, see the following resources:
 

articles/iot-operations/discover-manage-assets/media/concept-akri-architecture/akri-architecture.png

@@ -49,8 +49,6 @@ items:
         href: discover-manage-assets/concept-assets-asset-endpoints.md
       - name: Automatically discover assets
         href: discover-manage-assets/overview-akri.md
-      - name: Akri services architecture
-        href: discover-manage-assets/concept-akri-architecture.md
       - name: Manage your assets
         href: discover-manage-assets/howto-manage-assets-remotely.md
       - name: Secure access to your assets