Skip to content

Commit 15ab553

Browse files
authored
Updating azure guide (#524)
1 parent 047dced commit 15ab553

File tree

6 files changed

+40
-26
lines changed

6 files changed

+40
-26
lines changed

frontend/src/app/app-module/guides/guide-azure/guide-azure.component.html

Lines changed: 40 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,11 @@ <h4 class="card-title mb-0 text-primary">
55
</h4>
66
</div>
77
<div class="card-body">
8-
<h6 class="font-weight-semibold mb-3">
9-
Create Event Hub and Account Storage
10-
</h6>
118
<ol class="setup_list">
129
<li>
1310
<p class="step-guide">
1411
<span class="step_number">1</span>
15-
Create event hub, using the official Azure documentation
12+
Create <strong>"Event Hub"</strong>, using the official Azure documentation
1613
<a class="text-primary font-weight-semibold"
1714
href="https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-create"
1815
target="_blank">Quickstart: Create an event hub using Azure portal</a>
@@ -21,8 +18,9 @@ <h6 class="font-weight-semibold mb-3">
2118
<li>
2219
<p class="step-guide">
2320
<span class="step_number">2</span>
24-
Create a new "Shared access policy" to allow access to the Event Hub created, make sure you select the
25-
"Listen" permission
21+
Create a new <strong>"Shared access policy"</strong> to allow access to the Event Hub created, make sure you
22+
select the
23+
<strong>"Listen"</strong> permission.
2624
</p>
2725
<img alt="Azure portal" class="step-img"
2826
height="auto" src="../../../../assets/img/guides/azure/evenhubaccesspolicy.png"
@@ -31,38 +29,43 @@ <h6 class="font-weight-semibold mb-3">
3129
<li>
3230
<p class="step-guide">
3331
<span class="step_number">3</span>
34-
Get the Event Hub connection string from "Shared access policy" created previously.
32+
Get the <strong>Event Hub Shared Access policies - Connection string–primary key</strong> from <strong>"Shared
33+
access policy"</strong> created previously.
34+
It will be used to configure your tenant.
3535
</p>
3636
<img alt="Azure portal" class="step-img"
3737
height="auto" src="../../../../assets/img/guides/azure/aacess_shared_policy.png"
3838
width="800">
3939
<br>
4040
<br>
41-
Sample connection string:
41+
Sample <strong>Connection string–primary key</strong>:
4242
<app-utm-code-view
4343
[allowCopy]="false"
44-
code="Endpoint=sb://utmstack.servicebus.windows.net/;SharedAccessKeyName=activity-log-read-only;SharedAccessKey=mm6AbDcEfj8lk7sjsbzoTJ10qAkiSaG663YykEAG2eg=;EntityPath=insights-operational-logs">
44+
code="Endpoint=sb://utmstacksharedaccesspolicy.servicebus.windows.net/;SharedAccessKeyName=UTMStackSharedAccesspolicy;SharedAccessKey=A1xFRWsEKcS19gGPEykezcVsK4qLAcQ2K+AEhCyITzU=">
4545
</app-utm-code-view>
4646
</li>
4747
<li>
4848
<p class="step-guide">
4949
<span class="step_number">4</span>
50-
Get the name of the event group in: Azure Portal-> Event Hub -> Consumer groups.
50+
Get the <strong>Consumer Group Name</strong> in: All services-> Event Hubs -> Your_Event_Hub_Namespace ->
51+
Event Hubs -> Your_Event_Hub_Instance -> Consumer groups.
52+
It will be used to configure your tenant.
5153
</p>
5254
<img alt="Azure portal" class="step-img"
5355
height="auto" src="../../../../assets/img/guides/azure/consumer_group.png"
5456
width="600">
5557
<div class="alert alert-info alert-styled-right mt-3">
5658
Create a new consumer group specifically for Logstash. Do not use the $default or any other consumer group
57-
that might already be in use. Reusing consumer groups among non-related consumers can cause unexpected
58-
behavior and possibly lost events. All Logstash instances should use the same consumer group so that they can
59-
work together for processing events.
59+
that might already be in use.
60+
Reusing consumer groups among non-related consumers can cause unexpected behavior and possibly lost events.
61+
All Logstash instances should use the same consumer group so that they can work together for processing
62+
events.
6063
</div>
6164
</li>
6265
<li>
6366
<p class="step-guide">
6467
<span class="step_number">5</span>
65-
Create a storage account using the official Azure documentation
68+
Create a <strong>"Storage Account"</strong> using the official Azure documentation
6669
<a class="text-primary font-weight-semibold"
6770
href="https://docs.microsoft.com/en-us/azure/storage/common/storage-account-create?tabs=azure-portal"
6871
target="_blank">Quickstart: Create a storage account</a>
@@ -71,7 +74,8 @@ <h6 class="font-weight-semibold mb-3">
7174
<li>
7275
<p class="step-guide">
7376
<span class="step_number">6</span>
74-
Get the container name in: Azure Portal-> Storage account -> Containers.
77+
Get the <strong>"Storage Container Name"</strong> in: All services -> Storage account -> Your_Storage_Account
78+
-> Containers. It will be used to configure your tenant.
7579
</p>
7680
<img alt="Azure portal" class="step-img"
7781
height="auto" src="../../../../assets/img/guides/azure/container_name.png"
@@ -80,23 +84,20 @@ <h6 class="font-weight-semibold mb-3">
8084
<li>
8185
<p class="step-guide">
8286
<span class="step_number">7</span>
83-
Get the connection string to access Azure storage account. Find the connection string here: Azure Portal->
84-
Blob Storage account -> Access keys.
87+
Get the <strong>Storage Account Connection string with key</strong> to access Azure <strong>"Storage
88+
Account"</strong>.
89+
Find the connection string here: Azure Portal -> Blob Storage account -> Access keys. It will be used to
90+
configure your tenant.
8591
</p>
8692

8793
<img alt="Azure portal" class="step-img"
8894
height="auto" src="../../../../assets/img/guides/azure/account_storage.png"
8995
width="800">
90-
<div class="alert alert-info alert-styled-right mt-3">
91-
The offsets (position) of the Event Hubs are stored in the configured Azure Blob store. The Azure Blob store
92-
uses paths like a file system to store the offsets. If the paths between multiple Event Hubs overlap, then the
93-
offsets may be stored incorrectly.
94-
</div>
9596
<br>
9697
Sample connection string:
9798
<app-utm-code-view
9899
[allowCopy]="false"
99-
code="DefaultEndpointsProtocol=https;AccountName=logstash;AccountKey=ETOPnkd/hDAWidkEpPZDiXffQPku/SZdXhPSLnfqdRTalssdEuPkZwIcouzXjCLb/xPZjzhmHfwRCGo0SBSw==;EndpointSuffix=core.windows.net">
100+
code="DefaultEndpointsProtocol=https;AccountName=utmstackstorageaccount;AccountKey=ETOPnkd/hDAWidkEpPZDiXffQPku/SZdXhPSLnfqdRTalssdEuPkZwIcouzXjCLb/xPZjzhmHfwRCGo0SBSw==;EndpointSuffix=core.windows.net">
100101
</app-utm-code-view>
101102
</li>
102103
<li>
@@ -130,10 +131,23 @@ <h6 class="font-weight-semibold mb-3">
130131
<li>
131132
<p class="step-guide">
132133
<span class="step_number">11</span>
133-
Use the data collected in the previous step to fill the form. You can add more than one Event Hub
134-
configuration by clicking on the Add tenant button.
134+
Use the data collected in the previous steps to fill the form as documented below.
135+
You can add more than one Event Hub configuration by clicking on the Add tenant button.
135136
</p>
136-
137+
<ul class="mt-3 pl-3" style="list-style-type: circle !important;">
138+
<li>
139+
<strong>Event Hub Shared Access Policies - Connection string-primary key: </strong> <u>Value obtained in step 3</u>
140+
</li>
141+
<li>
142+
<strong>Consumer Group Name: </strong> <u>Value obtained in step 4</u>
143+
</li>
144+
<li>
145+
<strong>Storage Container Name: </strong> <u>Value obtained in step 6</u>
146+
</li>
147+
<li>
148+
<strong>Storage Account Connection string with key: </strong> <u>Value obtained in step 7</u>
149+
</li>
150+
</ul>
137151
<div class="row mt-3">
138152
<div class="col-lg-12 col-md-12 col-sm-12">
139153
<app-int-generic-group-config [moduleId]="integrationId"
46 KB
Loading
31.5 KB
Loading
33 KB
Loading
48.1 KB
Loading
-222 KB
Loading

0 commit comments

Comments
 (0)