你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Log Analytics - Get Log Analytics Metrics

参考

Service:: Front Door Service

API Version:: 2023-05-01

获取 AFD 配置文件的日志报告

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsMetrics?api-version=2023-05-01&metrics={metrics}&dateTimeBegin={dateTimeBegin}&dateTimeEnd={dateTimeEnd}&granularity={granularity}&customDomains={customDomains}&protocols={protocols}

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsMetrics?api-version=2023-05-01&metrics={metrics}&dateTimeBegin={dateTimeBegin}&dateTimeEnd={dateTimeEnd}&granularity={granularity}&groupBy={groupBy}&continents={continents}&countryOrRegions={countryOrRegions}&customDomains={customDomains}&protocols={protocols}

URI 参数

名称	在	必需	类型	说明
profileName	path	True	string	Azure Front Door Standard 或 Azure Front Door Premium 配置文件的名称，该配置文件在资源组中是唯一的。在资源组中是唯一的。
resourceGroupName	path	True	string	Azure 订阅中资源组的名称。 Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Azure 订阅 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。当前版本为 2023-05-01。
customDomains	query	True	string[]
dateTimeBegin	query	True	string date-time
dateTimeEnd	query	True	string date-time
granularity	query	True	LogMetricsGranularity
metrics	query	True	LogMetric[]
protocols	query	True	string[]
continents	query		string[]
countryOrRegions	query		string[]
groupBy	query		LogMetricsGroupBy[]

响应

名称	类型	说明
200 OK	MetricsResponse	描述成功操作的结果。
Other Status Codes	AfdErrorResponse	描述操作失败原因的 Azure Front Door 错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

LogAnalytics_GetLogAnalyticsMetrics

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/getLogAnalyticsMetrics?api-version=2023-05-01&metrics=clientRequestCount&dateTimeBegin=2020-11-04T04:30:00.000Z&dateTimeEnd=2020-11-04T05:00:00.000Z&granularity=PT5M&groupBy=protocol&customDomains=customdomain1.azurecdn.net&customDomains=customdomain2.azurecdn.net&protocols=https


import com.azure.resourcemanager.cdn.models.LogMetric;
import com.azure.resourcemanager.cdn.models.LogMetricsGranularity;
import com.azure.resourcemanager.cdn.models.LogMetricsGroupBy;
import java.time.OffsetDateTime;
import java.util.Arrays;

/** Samples for LogAnalytics GetLogAnalyticsMetrics. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/LogAnalytics_GetLogAnalyticsMetrics.
     * json
     */
    /**
     * Sample code: LogAnalytics_GetLogAnalyticsMetrics.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void logAnalyticsGetLogAnalyticsMetrics(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cdnProfiles().manager().serviceClient().getLogAnalytics().getLogAnalyticsMetricsWithResponse("RG",
            "profile1", Arrays.asList(LogMetric.CLIENT_REQUEST_COUNT), OffsetDateTime.parse("2020-11-04T04:30:00.000Z"),
            OffsetDateTime.parse("2020-11-04T05:00:00.000Z"), LogMetricsGranularity.PT5M,
            Arrays.asList("customdomain1.azurecdn.net", "customdomain2.azurecdn.net"), Arrays.asList("https"),
            Arrays.asList(LogMetricsGroupBy.PROTOCOL), null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

import isodate

from azure.identity import DefaultAzureCredential
from azure.mgmt.cdn import CdnManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cdn
# USAGE
    python log_analytics_get_log_analytics_metrics.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CdnManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.log_analytics.get_log_analytics_metrics(
        resource_group_name="RG",
        profile_name="profile1",
        metrics=["clientRequestCount"],
        date_time_begin=isodate.parse_datetime("2020-11-04T04:30:00.000Z"),
        date_time_end=isodate.parse_datetime("2020-11-04T05:00:00.000Z"),
        granularity="PT5M",
        custom_domains=["customdomain1.azurecdn.net", "customdomain2.azurecdn.net"],
        protocols=["https"],
    )
    print(response)


# x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/LogAnalytics_GetLogAnalyticsMetrics.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcdn_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cdn/armcdn/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7b551033155a63739b6d28f79b9c07569f6179b8/specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/LogAnalytics_GetLogAnalyticsMetrics.json
func ExampleLogAnalyticsClient_GetLogAnalyticsMetrics() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcdn.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewLogAnalyticsClient().GetLogAnalyticsMetrics(ctx, "RG", "profile1", []armcdn.LogMetric{
		armcdn.LogMetricClientRequestCount}, func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:30:00.000Z"); return t }(), func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T05:00:00.000Z"); return t }(), armcdn.LogMetricsGranularityPT5M, []string{
		"customdomain1.azurecdn.net",
		"customdomain2.azurecdn.net"}, []string{
		"https"}, &armcdn.LogAnalyticsClientGetLogAnalyticsMetricsOptions{GroupBy: []armcdn.LogMetricsGroupBy{
		armcdn.LogMetricsGroupByProtocol},
		Continents:       []string{},
		CountryOrRegions: []string{},
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.MetricsResponse = armcdn.MetricsResponse{
	// 	DateTimeBegin: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:30:27.554Z"); return t}()),
	// 	DateTimeEnd: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T05:00:27.554Z"); return t}()),
	// 	Granularity: to.Ptr(armcdn.MetricsGranularityPT5M),
	// 	Series: []*armcdn.MetricsResponseSeriesItem{
	// 		{
	// 			Data: []*armcdn.Components1Gs0LlpSchemasMetricsresponsePropertiesSeriesItemsPropertiesDataItems{
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:35:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](4250),
	// 				},
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:40:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](3120),
	// 				},
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:45:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](2221),
	// 				},
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:50:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](2466),
	// 				},
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T04:55:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](2654),
	// 				},
	// 				{
	// 					DateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-04T05:00:00.000Z"); return t}()),
	// 					Value: to.Ptr[float32](3565),
	// 			}},
	// 			Groups: []*armcdn.MetricsResponseSeriesPropertiesItemsItem{
	// 				{
	// 					Name: to.Ptr("protocol"),
	// 					Value: to.Ptr("https"),
	// 			}},
	// 			Metric: to.Ptr("clientRequestCount"),
	// 			Unit: to.Ptr(armcdn.MetricsSeriesUnitCount),
	// 	}},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { CdnManagementClient } = require("@azure/arm-cdn");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Get log report for AFD profile
 *
 * @summary Get log report for AFD profile
 * x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2023-05-01/examples/LogAnalytics_GetLogAnalyticsMetrics.json
 */
async function logAnalyticsGetLogAnalyticsMetrics() {
  const subscriptionId = process.env["CDN_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["CDN_RESOURCE_GROUP"] || "RG";
  const profileName = "profile1";
  const metrics = ["clientRequestCount"];
  const dateTimeBegin = new Date("2020-11-04T04:30:00.000Z");
  const dateTimeEnd = new Date("2020-11-04T05:00:00.000Z");
  const granularity = "PT5M";
  const groupBy = ["protocol"];
  const customDomains = ["customdomain1.azurecdn.net", "customdomain2.azurecdn.net"];
  const protocols = ["https"];
  const options = { groupBy };
  const credential = new DefaultAzureCredential();
  const client = new CdnManagementClient(credential, subscriptionId);
  const result = await client.logAnalytics.getLogAnalyticsMetrics(
    resourceGroupName,
    profileName,
    metrics,
    dateTimeBegin,
    dateTimeEnd,
    granularity,
    customDomains,
    protocols,
    options
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "dateTimeBegin": "2020-11-04T12:30:27.554+08:00",
  "dateTimeEnd": "2020-11-04T13:00:27.554+08:00",
  "granularity": "PT5M",
  "series": [
    {
      "metric": "clientRequestCount",
      "unit": "count",
      "groups": [
        {
          "name": "protocol",
          "value": "https"
        }
      ],
      "data": [
        {
          "dateTime": "2020-11-04T04:35:00+00:00",
          "value": 4250
        },
        {
          "dateTime": "2020-11-04T04:40:00+00:00",
          "value": 3120
        },
        {
          "dateTime": "2020-11-04T04:45:00+00:00",
          "value": 2221
        },
        {
          "dateTime": "2020-11-04T04:50:00+00:00",
          "value": 2466
        },
        {
          "dateTime": "2020-11-04T04:55:00+00:00",
          "value": 2654
        },
        {
          "dateTime": "2020-11-04T05:00:00+00:00",
          "value": 3565
        }
      ]
    }
  ]
}

定义

名称	说明
AfdErrorResponse	错误响应
Data
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
Groups
LogMetric
LogMetricsGranularity
LogMetricsGroupBy
MetricsGranularity
MetricsResponse	指标响应
MetricsSeriesUnit
Series

AfdErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

Data

名称	类型	说明
dateTime	string
value	number

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

Groups

名称	类型	说明
name	string
value	string

LogMetric

名称	类型	说明
clientRequestBandwidth	string
clientRequestCount	string
clientRequestTraffic	string
originRequestBandwidth	string
originRequestTraffic	string
totalLatency	string

LogMetricsGranularity

名称	类型	说明
P1D	string
PT1H	string
PT5M	string

LogMetricsGroupBy

名称	类型	说明
cacheStatus	string
countryOrRegion	string
customDomain	string
httpStatusCode	string
protocol	string

MetricsGranularity

名称	类型	说明
P1D	string
PT1H	string
PT5M	string

MetricsResponse

指标响应

名称	类型	说明
dateTimeBegin	string
dateTimeEnd	string
granularity	MetricsGranularity
series	Series[]

MetricsSeriesUnit

名称	类型	说明
bitsPerSecond	string
bytes	string
count	string
milliSeconds	string

Series

名称	类型	说明
data	Data[]
groups	Groups[]
metric	string
unit	MetricsSeriesUnit

Log Analytics - Get Log Analytics Metrics

URI 参数

响应

安全性

azure_auth

Scopes

示例

LogAnalytics_GetLogAnalyticsMetrics

Sample Request

Sample Response

定义

AfdErrorResponse

Data

ErrorAdditionalInfo

ErrorDetail

Groups

LogMetric

LogMetricsGranularity

LogMetricsGroupBy

MetricsGranularity

MetricsResponse

MetricsSeriesUnit

Series

其他资源