Skip to content

Commit c828f7a

Browse files
committed
fix and update
1 parent dda38eb commit c828f7a

File tree

3 files changed

+23
-80
lines changed

3 files changed

+23
-80
lines changed

articles/storage/files/analyze-files-metrics.md

Lines changed: 2 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -320,85 +320,11 @@ Compared against the **Bandwidth by Max MiB/s**, we achieved 123 MiB/s at peak.
320320

321321
:::image type="content" source="media/analyze-files-metrics/bandwidth-by-max-mibs.png" alt-text="Screenshot showing bandwidth by max MIBS." lightbox="media/analyze-files-metrics/bandwidth-by-max-mibs.png" border="false":::
322322

323-
## Analyze logs
324-
325-
You can access resource logs either as a blob in a storage account, as event data, or through Log Analytics queries. For information about how to find those logs, see [Azure resource logs](../../azure-monitor/essentials/resource-logs.md).
326-
327-
All resource logs in Azure Monitor have the same fields followed by service-specific fields. The common schema is outlined in [Azure Monitor resource log schema](../../azure-monitor/essentials/resource-logs-schema.md). The schema for Azure Files resource logs is found in [Azure Files monitoring data reference](storage-files-monitoring-reference.md).
328-
329-
To get the list of SMB and REST operations that are logged, see [Storage logged operations and status messages](/rest/api/storageservices/storage-analytics-logged-operations-and-status-messages).
330-
331-
Log entries are created only if there are requests made against the service endpoint. For example, if a storage account has activity in its file endpoint but not in its table or queue endpoints, only logs that pertain to the Azure File service are created. Azure Storage logs contain detailed information about successful and failed requests to a storage service. This information can be used to monitor individual requests and to diagnose issues with a storage service. Requests are logged on a best-effort basis.
332-
333-
The [Activity log](../../azure-monitor/essentials/activity-log.md) is a type of platform log located in Azure that provides insight into subscription-level events. You can view it independently or route it to Azure Monitor Logs, where you can do much more complex queries using Log Analytics.
334-
335-
336-
### Log authenticated requests
337-
338-
The following types of authenticated requests are logged:
339-
340-
- Successful requests
341-
- Failed requests, including timeout, throttling, network, authorization, and other errors
342-
- Requests that use Kerberos, NTLM or shared access signature (SAS), including failed and successful requests
343-
- Requests to analytics data (classic log data in the **$logs** container and classic metric data in the **$metric** tables)
344-
345-
Requests made by the Azure Files service itself, such as log creation or deletion, aren't logged. For a full list of the SMB and REST requests that are logged, see [Storage logged operations and status messages](/rest/api/storageservices/storage-analytics-logged-operations-and-status-messages) and [Azure Files monitoring data reference](storage-files-monitoring-reference.md).
346-
347-
### Sample Kusto queries
348-
349-
If you send logs to Log Analytics, you can access those logs by using Azure Monitor log queries. For more information, see [Log Analytics tutorial](/azure/azure-monitor/logs/log-analytics-tutorial).
350-
351-
Here are some queries that you can enter in the **Log search** bar to help you monitor your Azure Files. These queries work with the [new language](/azure/azure-monitor/logs/log-query-overview).
352-
353-
> [!IMPORTANT]
354-
> When you select **Logs** from the storage account resource group menu, Log Analytics is opened with the query scope set to the current resource group. This means that log queries will only include data from that resource group. If you want to run a query that includes data from other resources or data from other Azure services, select **Logs** from the **Azure Monitor** menu. See [Log query scope and time range in Azure Monitor Log Analytics](/azure/azure-monitor/logs/scope) for details.
355-
356-
Use these queries to help you monitor your Azure file shares:
357-
358-
- View SMB errors over the last week
359-
360-
```Kusto
361-
StorageFileLogs
362-
| where Protocol == "SMB" and TimeGenerated >= ago(7d) and StatusCode contains "-"
363-
| sort by StatusCode
364-
```
365-
- Create a pie chart of SMB operations over the last week
366-
367-
```Kusto
368-
StorageFileLogs
369-
| where Protocol == "SMB" and TimeGenerated >= ago(7d)
370-
| summarize count() by OperationName
371-
| sort by count_ desc
372-
| render piechart
373-
```
374-
375-
- View REST errors over the last week
376-
377-
```Kusto
378-
StorageFileLogs
379-
| where Protocol == "HTTPS" and TimeGenerated >= ago(7d) and StatusText !contains "Success"
380-
| sort by StatusText asc
381-
```
382-
383-
- Create a pie chart of REST operations over the last week
384-
385-
```Kusto
386-
StorageFileLogs
387-
| where Protocol == "HTTPS" and TimeGenerated >= ago(7d)
388-
| summarize count() by OperationName
389-
| sort by count_ desc
390-
| render piechart
391-
```
392-
393-
To view the list of column names and descriptions for Azure Files, see [StorageFileLogs](/azure/azure-monitor/reference/tables/storagefilelogs).
394-
395-
For more information on how to write queries, see [Log Analytics tutorial](/azure/azure-monitor/logs/log-analytics-tutorial).
396-
397-
## Next steps
323+
## Related content
398324

399325
- [Monitor Azure Files](storage-files-monitoring.md)
400-
- [Create monitoring alerts for Azure Files](files-monitoring-alerts.md)
401326
- [Azure Files monitoring data reference](storage-files-monitoring-reference.md)
327+
- [Create monitoring alerts for Azure Files](files-monitoring-alerts.md)
402328
- [Monitor Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource)
403329
- [Understand Azure Files performance](understand-performance.md)
404330
- [Troubleshoot ClientOtherErrors](/troubleshoot/azure/azure-storage/files-client-other-errors?toc=/azure/storage/files/toc.json)

articles/storage/files/files-monitoring-alerts.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ ms.custom: monitoring
1414

1515
Azure Monitor alerts proactively notify you when important conditions are found in your monitoring data. They allow you to identify and address issues in your system before your customers notice them. You can set alerts on [metrics](/azure/azure-monitor/alerts/alerts-metric-overview), [logs](/azure/azure-monitor/alerts/alerts-unified-log), and the [activity log](/azure/azure-monitor/alerts/activity-log-alerts).
1616

17-
To learn more about how to create an alert, see [Create or edit an alert rule](/azure/azure-monitor/alerts/alerts-create-new-alert-rule).
17+
This article shows you how to create alerts on throttling, capacity, egress, and high server latency. To learn more about creating alerts, see [Create or edit an alert rule](/azure/azure-monitor/alerts/alerts-create-new-alert-rule).
1818

1919
For more information about alert types and alerts, see [Monitor Azure Files](storage-files-monitoring.md#alerts).
2020

@@ -158,10 +158,10 @@ To create an alert for high server latency (average), follow these steps.
158158

159159
8. Select **Review + create** to create the alert.
160160

161-
## Next steps
161+
## Related content
162162

163163
- [Monitor Azure Files](storage-files-monitoring.md)
164-
- [Analyze Azure Files metrics using Azure Monitor](analyze-files-metrics.md)
165164
- [Azure Files monitoring data reference](storage-files-monitoring-reference.md)
165+
- [Analyze Azure Files metrics](analyze-files-metrics.md)
166166
- [Monitor Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource)
167167
- [Azure Storage metrics migration](../common/storage-metrics-migration.md)

articles/storage/files/storage-files-monitoring.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,16 +126,31 @@ If your service has other logs that aren't resource logs or in the activity log,
126126
<!-- ANALYSIS SECTION START -------------------------------------->
127127

128128
<!-- ## Analyze data. Required section. -->
129-
<a name="analyzing-logs"></a>
130129
[!INCLUDE [horz-monitor-analyze-data](~/articles/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-analyze-data.md)]
131130

132131
<!-- ### External tools. Required section. -->
133132
[!INCLUDE [horz-monitor-external-tools](~/articles/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-external-tools.md)]
134133

134+
### Analyze metrics for Azure Files
135+
136+
Metrics for Azure Files are in these namespaces:
137+
138+
- Microsoft.Storage/storageAccounts
139+
- Microsoft.Storage/storageAccounts/fileServices
140+
141+
For a list of available metrics for Azure Files, see [Azure Files monitoring data reference](storage-files-monitoring-reference.md).
142+
143+
For a list of all Azure Monitor support metrics, which includes Azure Files, see [Azure Monitor supported metrics](/azure/azure-monitor/essentials/metrics-supported#microsoftstoragestorageaccountsfileservices).
144+
145+
For detailed instructions on how to analyze Azure Files metrics such as availability, latency, and utilization, see [Analyze Azure Files metrics using Azure Monitor](analyze-files-metrics.md).
146+
147+
<a name="analyzing-logs"></a>
135148
### Analyze logs for Azure Files
136149

137150
You can access resource logs either as a blob in a storage account, as event data, or through Log Analytics queries. For information about how to find those logs, see [Azure resource logs](/azure/azure-monitor/essentials/resource-logs).
138151

152+
To get the list of SMB and REST operations that are logged, see [Storage logged operations and status messages](/rest/api/storageservices/storage-analytics-logged-operations-and-status-messages) and [Azure Files monitoring data reference](storage-files-monitoring-reference.md).
153+
139154
Log entries are created only if there are requests made against the service endpoint. For example, if a storage account has activity in its file endpoint but not in its table or queue endpoints, only logs that pertain to the Azure File service are created. Azure Storage logs contain detailed information about successful and failed requests to a storage service. This information can be used to monitor individual requests and to diagnose issues with a storage service. Requests are logged on a best-effort basis.
140155

141156
#### Log authenticated requests
@@ -221,6 +236,8 @@ The following table lists common and recommended alert rules for Azure Files and
221236
|Metric | File share egress exceeds 500 GiB in one day. | Egress<br>Dimension name: FileShare (premium file share only) |
222237
|Metric | High server latency. | Success Server Latency<br>Dimension name: API Name, for example Read and Write API|
223238

239+
For instructions on how to create alerts on throttling, capacity, egress, and high server latency, see [Create monitoring alerts for Azure Files](files-monitoring-alerts.md).
240+
224241
<!-- ### Advisor recommendations -->
225242
[!INCLUDE [horz-monitor-advisor-recommendations](~/articles/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-advisor-recommendations.md)]
226243

0 commit comments

Comments
 (0)