Merge pull request #102724 from itechedit/three-event-hubs-articles

edit pass: Three event-hubs articles

Author: ShawnJackson

articles/event-hubs/get-started-capture-python-v2.md

@@ -1,6 +1,6 @@
 ---
-title: Read Azure Event Hubs captured data from Python app | Microsoft Docs
-description: This article shows you how to write Python code to capture data that's sent to an event hub and read the captured event data from an Azure Storage. 
+title: Read Azure Event Hubs captured data from a Python app | Microsoft Docs
+description: This article shows you how to write Python code to capture data that's sent to an event hub and read the captured event data from an Azure storage account. 
 services: event-hubs
 documentationcenter: ''
 author: spelluru
@@ -16,13 +16,14 @@ ms.author: spelluru
 
 ---
 
-# Capture Event Hubs data in Azure Storage and read it using Python 
-You can use configure an event hub so that the data sent to an event hub is captured in an Azure Storage or Azure Data Lake Storage. This article shows you how to use write Python code to send events to an event hub and read the captured data from an Azure blob storage. For more information about this feature, see the [Event Hubs Capture feature overview](event-hubs-capture-overview.md).
+# Capture Event Hubs data in Azure Storage and read it by using Python 
 
-This sample uses the [Azure Python SDK](https://azure.microsoft.com/develop/python/) to demonstrate the Capture feature. The sender.py program sends simulated environmental telemetry to Event Hubs in JSON format. The event hub is configured to use the Capture feature to write this data to Blob storage in batches. The capturereader.py app reads these blobs and creates an append file per device. The app then writes the data into .csv files.
+You can configure an event hub so that the data that's sent to an event hub is captured in an Azure storage account or Azure Data Lake Storage. This article shows you how to write Python code to send events to an event hub and read the captured data from Azure Blob storage. For more information about this feature, see [Event Hubs Capture feature overview](event-hubs-capture-overview.md).
+
+This quickstart uses the [Azure Python SDK](https://azure.microsoft.com/develop/python/) to demonstrate the Capture feature. The *sender.py* app sends simulated environmental telemetry to event hubs in JSON format. The event hub is configured to use the Capture feature to write this data to Blob storage in batches. The *capturereader.py* app reads these blobs and creates an append file for each device. The app then writes the data into CSV files.
 
 > [!IMPORTANT]
-> This quickstart uses version 5 of the Azure Event Hubs Python SDK. For a quick start that uses the old version 1 of the Python SDK, see [this article](event-hubs-capture-python.md). If you are using version 1 of the SDK, we recommend that you migrate your code to the latest version. For details, see the [migration guide](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub/migration_guide.md).
+> This quickstart uses version 5 of the Azure Event Hubs Python SDK. For a quickstart that uses version 1 of the Python SDK, see [Quickstart: Event Hubs Capture walkthrough - Python](event-hubs-capture-python.md). If you're using version 1 of the SDK, we recommend that you migrate your code to the latest version. For more information, see the [migration guide](https://github.com/Azure/azure-sdk-for-python/blob/master/sdk/eventhub/azure-eventhub/migration_guide.md).
 
 In this quickstart, you: 
 
@@ -35,23 +36,24 @@ In this quickstart, you:
 
 ## Prerequisites
 
-- Python 2.7, and 3.5 or later, with `pip` installed and updated.
-- An Azure subscription. If you don't have one, [create a free account](https://azure.microsoft.com/free/) before you begin.
-- [Create an Event Hubs namespace and an event hub in the namespace](event-hubs-create.md). Note down the name of the Event Hubs namespace, name of the event hub, and the primary access key for the namespace. Get the access key by following instructions from the article: [Get connection string](event-hubs-get-connection-string.md#get-connection-string-from-the-portal). The default key name is: **RootManageSharedAccessKey**. You don't need the connection string for the tutorial. You just need the primary key. 
-- Follow these steps to create an **Azure Storage account** and a **blob container**:
-    1. [Create an Azure Storage account](../storage/common/storage-quickstart-create-account.md?tabs=azure-portal).
-    2. [Create a blob container in the storage](../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container). 
-    3. [Get the connection string to the storage account](../storage/common/storage-configure-connection-string.md#view-and-copy-a-connection-string).
+- Python 2.7, and 3.5 or later, with PIP installed and updated.  
+- An Azure subscription. If you don't have one, [create a free account](https://azure.microsoft.com/free/) before you begin.  
+- An active Event Hubs namespace and event hub.
+[Create an Event Hubs namespace and an event hub in the namespace](event-hubs-create.md). Record the name of the Event Hubs namespace, the name of the event hub, and the primary access key for the namespace. To get the access key, see [Get an Event Hubs connection string](event-hubs-get-connection-string.md#get-connection-string-from-the-portal). The default key name is *RootManageSharedAccessKey*. For this quickstart, you need only the primary key. You don't need the connection string.  
+- An Azure storage account, a blob container in the storage account, and a connection string to the storage account. If you don't have these items, do the following:  
+    1. [Create an Azure storage account](../storage/common/storage-quickstart-create-account.md?tabs=azure-portal)  
+    1. [Create a blob container in the storage account](../storage/blobs/storage-quickstart-blobs-portal.md#create-a-container)  
+    1. [Get the connection string to the storage account](../storage/common/storage-configure-connection-string.md#view-and-copy-a-connection-string)
 
-        Note down **connection string** and the **container name**. You will use them later in the code. 
-- Enable **Capture** feature for the event hub by following instructions from: [Enable Event Hubs Capture using the Azure portal](event-hubs-capture-enable-through-portal.md). Select the storage account and the blob container you created in the previous step. You can also enable the feature when creating an event hub. 
+    Be sure to record the connection string and container name for later use in this quickstart.  
+- Enable the Capture feature for the event hub. To do so, follow the instructions in [Enable Event Hubs Capture using the Azure portal](event-hubs-capture-enable-through-portal.md). Select the storage account and the blob container you created in the preceding step. You can also enable the feature when you create an event hub.  
 
 ## Create a Python script to send events to your event hub
-In this section, you create a Python script that sends 200 events (10 devices * 20 events) to an event hub. These events are sample environmental reading sent in JSON format. 
+In this section, you create a Python script that sends 200 events (10 devices * 20 events) to an event hub. These events are a sample environmental reading that's sent in JSON format. 
 
 1. Open your favorite Python editor, such as [Visual Studio Code][Visual Studio Code].
-2. Create a script called **sender.py**. 
-3. Paste the following code into sender.py. See the code comments for details. 
+2. Create a script called *sender.py*. 
+3. Paste the following code into *sender.py*. 
 
     ```python
     import time
@@ -63,39 +65,39 @@ In this section, you create a Python script that sends 200 events (10 devices *
 
     from azure.eventhub import EventHubProducerClient, EventData
 
-    # this scripts simulates production of events for 10 devices
+    # This script simulates the production of events for 10 devices.
     devices = []
     for x in range(0, 10):
         devices.append(str(uuid.uuid4()))
 
-    # create a producer client to produce/publish events to the event hub
+    # Create a producer client to produce and publish events to the event hub.
     producer = EventHubProducerClient.from_connection_string(conn_str="EVENT HUBS NAMESAPCE CONNECTION STRING", eventhub_name="EVENT HUB NAME")
 
-    for y in range(0,20):    # for each device, produce 20 events 
-        event_data_batch = producer.create_batch() # create a batch. you will add events to the batch later. 
+    for y in range(0,20):    # For each device, produce 20 events. 
+        event_data_batch = producer.create_batch() # Create a batch. You will add events to the batch later. 
         for dev in devices:
-            # create a dummy reading
+            # Create a dummy reading.
             reading = {'id': dev, 'timestamp': str(datetime.datetime.utcnow()), 'uv': random.random(), 'temperature': random.randint(70, 100), 'humidity': random.randint(70, 100)}
-            s = json.dumps(reading) # convert reading into a JSON string
-            event_data_batch.add(EventData(s)) # add event data to the batch
-        producer.send_batch(event_data_batch) # send the batch of events to the event hub
+            s = json.dumps(reading) # Convert the reading into a JSON string.
+            event_data_batch.add(EventData(s)) # Add event data to the batch.
+        producer.send_batch(event_data_batch) # Send the batch of events to the event hub.
 
-    # close the producer    
+    # Close the producer.    
     producer.close()
     ```
-4. Replace the following values in the scripts:
-    1. Replace `EVENT HUBS NAMESPACE CONNECTION STRING` with the connection string for your Event Hubs namespace.
-    2. Replace `EVENT HUB NAME` with the name of your event hub. 
-5. Run the script to send events to the event hub. 
-6. In the Azure portal, you can verify that the event hub has received the messages. Switch to **Messages** view in the **Metrics** section. Refresh the page to update the chart. It may take a few seconds for it to show that the messages have been received. 
+4. Replace the following values in the scripts:  
+    * Replace `EVENT HUBS NAMESPACE CONNECTION STRING` with the connection string for your Event Hubs namespace.  
+    * Replace `EVENT HUB NAME` with the name of your event hub.  
+5. Run the script to send events to the event hub.  
+6. In the Azure portal, you can verify that the event hub has received the messages. Switch to **Messages** view in the **Metrics** section. Refresh the page to update the chart. It might take a few seconds for the page to display that the messages have been received. 
 
     [![Verify that the event hub received the messages](./media/get-started-capture-python-v2/messages-portal.png)](./media/get-started-capture-python-v2/messages-portal.png#lightbox)
 
 ## Create a Python script to read your Capture files
-In this example, the captured data is stored in Azure Blob Storage. The script in this section reads the capture data files from your Azure Storage and generates CSV files for you to easily open and view the contents. You will see 10 files in the current working directory of the application. These files will contain the environmental readings for the 10 devices. 
+In this example, the captured data is stored in Azure Blob storage. The script in this section reads the captured data files from your Azure storage account and generates CSV files for you to easily open and view. You will see 10 files in the current working directory of the application. These files will contain the environmental readings for the 10 devices. 
 
-1. In your Python editor, create a script called **capturereader.py**. This script reads the captured files and creates a file per device to write the data only for that device.
-2. Paste the following code into capturereader.py. See the code comments for details. 
+1. In your Python editor, create a script called *capturereader.py*. This script reads the captured files and creates a file for each device to write the data only for that device.
+2. Paste the following code into *capturereader.py*. 
 
     ```python
     import os
@@ -131,28 +133,28 @@ In this example, the captured data is stored in Azure Blob Storage. The script i
 
     def startProcessing():
         print('Processor started using path: ' + os.getcwd())
-        # create a blob container client
+        # Create a blob container client.
         container = ContainerClient.from_connection_string("AZURE STORAGE CONNECTION STRING", container_name="BLOB CONTAINER NAME")
-        blob_list = container.list_blobs() # list all the blobs in the container
+        blob_list = container.list_blobs() # List all the blobs in the container.
         for blob in blob_list:
-            #content_length == 508 is an empty file, so only process content_length > 508 (skip empty files)        
+            # Content_length == 508 is an empty file, so process only content_length > 508 (skip empty files).        
             if blob.size > 508:
                 print('Downloaded a non empty blob: ' + blob.name)
-                # create a blob client for the blob
+                # Create a blob client for the blob.
                 blob_client = ContainerClient.get_blob_client(container, blob=blob.name)
-                # construct a file name based on the blob name
+                # Construct a file name based on the blob name.
                 cleanName = str.replace(blob.name, '/', '_')
                 cleanName = os.getcwd() + '\\' + cleanName 
-                with open(cleanName, "wb+") as my_file: # open the file to write. create if it doesn't exist. 
-                    my_file.write(blob_client.download_blob().readall()) # write blob contents into the file
-                processBlob2(cleanName) # convert the file into a CSV file
-                os.remove(cleanName) # remove the original downloaded file
-                # delete the blob from the container after it's read
+                with open(cleanName, "wb+") as my_file: # Open the file to write. Create it if it doesn't exist. 
+                    my_file.write(blob_client.download_blob().readall()) # Write blob contents into the file.
+                processBlob2(cleanName) # Convert the file into a CSV file.
+                os.remove(cleanName) # Remove the original downloaded file.
+                # Delete the blob from the container after it's read.
                 container.delete_blob(blob.name)
 
     startProcessing()    
     ```
-4. Replace `<AZURE STORAGE CONNECTION STRING>` with the connection string for your Azure Storage account. The name of container you created in this tutorial is: **capture**. If you used a different name for the container, replace `capture` with the name of the container in the storage account. 
+3. Replace `AZURE STORAGE CONNECTION STRING` with the connection string for your Azure storage account. The name of the container you created in this quickstart is *capture*. If you used a different name for the container, replace *capture* with the name of the container in the storage account. 
 
 ## Run the scripts
 1. Open a command prompt that has Python in its path, and then run these commands to install Python prerequisite packages:
@@ -162,23 +164,23 @@ In this example, the captured data is stored in Azure Blob Storage. The script i
    pip install azure-eventhub
    pip install avro-python3
    ```
-2. Change your directory to wherever you saved sender.py and capturereader.py, and run this command:
+2. Change your directory to the directory where you saved *sender.py* and *capturereader.py*, and run this command:
 
    ```
    python sender.py
    ```
 
    This command starts a new Python process to run the sender.
-3. Wait a few minutes for the capture to run. Then type the following command into your original command window:
+3. Wait a few minutes for the capture to run, and then enter the following command in your original command window:
 
    ```
    python capturereader.py
    ```
 
-   This capture processor uses the local directory to download all the blobs from the storage account/container. It processes any that are not empty, and it writes the results as .csv files into the local directory.
+   This capture processor uses the local directory to download all the blobs from the storage account and container. It processes any that are not empty, and it writes the results as CSV files into the local directory.
 
 ## Next steps
-Check out Python samples on the GitHub [here](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/eventhub/azure-eventhub/samples). 
+Check out [Python samples on GitHub](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/eventhub/azure-eventhub/samples). 
 
 
 [Azure portal]: https://portal.azure.com/