Cấu hình nhật ký hành động dòng màn hình nền

Bài viết
08/05/2024

Trang này cung cấp hướng dẫn cấu hình cho nhật ký dòng màn hình nền, nằm trong phần tính năng của môi trường trong trung tâm quản trị Power Platform .

Quan trọng

Tính năng này chỉ áp dụng cho các luồng máy tính để bàn được khởi chạy từ dòng đám mây và chưa khả dụng cho các lần chạy cục bộ có giám sát từ Power Automate máy tính để bàn.
Mặc dù cấu hình nhật ký dòng màn hình nền hiện đã khả dụng rộng rãi, một số cấu hình được gắn nhãn là "bản xem trước" như loại nhật ký hành động Logs V2 vẫn có trong bản xem trước và được cung cấp trước khi phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi. Các tính năng bản xem trước không dành cho mục đích sử dụng sản xuất và có thể có chức năng hạn chế.

Cài đặt Trạng thái kích hoạt của nhật ký hành động chạy xác định thời điểm nhật ký hành động chạy dòng màn hình nền sẽ được ghi lại và thậm chí cho phép bạn tắt hoàn toàn nhật ký.

Trạng thái kích hoạt	Thông tin chi tiết
Đã bật (mặc định)	Tùy chọn này là mặc định cho cả môi trường hiện tại và môi trường mới, nơi nhật ký được ghi lại như bình thường.
Lỗi khi chạy	Tùy chọn này chỉ ghi lại nhật ký hành động dòng màn hình nền khi có lỗi thời gian chạy. Điều này có nghĩa là nhật ký không có sẵn cho mọi lần chạy mà chỉ có sẵn khi xảy ra lỗi. Tuy nhiên, nếu lỗi xảy ra, tất cả nhật ký cho lần chạy cụ thể đó đều có sẵn, bao gồm cả hành động thành công và thất bại.
Tàn tật	Tùy chọn này có hiệu quả vô hiệu hóa hoàn toàn nhật ký hành động chạy dòng màn hình nền.

Thận trọng

Thay đổi bất kỳ cài đặt nào trong số này cũng có thể có tác động đáng kể đến các tính năng như xử lý sự cố lỗi chạy và kiểm tra. Hãy cân nhắc những tác động của việc thay đổi các thiết lập này trước khi tiếp tục.

Cấu hình phiên bản nhật ký hành động dòng màn hình nền (bản xem trước)

Phiên bản Nhật ký hành động cho phép bạn chọn V1, V2 hoặc cả hai.

Phiên bản nhật ký	Giải thích
V1 - Được lưu trữ trong trường AdditionalContext của thực thể FlowSession	Tùy chọn này là mặc định. Nhật ký được lưu trữ trong trường AdditionalContext của bảng Phiên luồng, đây là thuộc tính tệp được lưu trữ dưới dạng blob trong Microsoft Dataverse. Nhật ký V1 sử dụng Dataverse dung lượng tệp. Tính năng này hiện có sẵn (GA).
V2 - Được lưu trữ trong thực thể FlowLogs (bản xem trước)	Tùy chọn bản xem trước mới này cho phép bạn lưu trữ nhật ký trong bảng Nhật ký luồng, được lưu trữ trong Bảng đàn hồi. Nhật ký V2 sử dụng Dataverse dung lượng cơ sở dữ liệu. Tính năng này hiện ở chế độ xem trước công khai.
Cả hai (bản xem trước)	Thiết lập bản xem trước này cho phép lưu trữ nhật ký trong cả trường AdditionalContext truyền thống của bảng Flow Session và bảng Flow Logs. Tính năng này có trong bản xem trước và sử dụng cả dung lượng tệp và cơ sở dữ liệu. Dataverse Thiết lập này dành cho mục đích gỡ lỗi hoặc thử nghiệm vì nó sử dụng cả Dataverse dung lượng cơ sở dữ liệu và tệp. Tính năng này hiện ở chế độ xem trước công khai.

Giá trị Thời gian tồn tại của thực thể FlowLogs tính bằng phút (bản xem trước) xác định thời gian lưu giữ nhật ký hành động trong bảng đàn hồi Flow Logs. Dataverse tự động xóa các bản ghi cũ hơn khung thời gian đã chỉ định. Sau đây là một số giá trị mẫu để bạn tham khảo.

Ngày	Phút
1 ngày	1,440 phút
Ba ngày	4,320 phút
7 ngày	10,080 phút
14 ngày	20,160 phút
28 ngày	40,320 phút
60 ngày	86,400 phút
90 ngày	129,600 phút
180 ngày	259,200 phút
365 ngày	525,600 phút
Mãi mãi	Nhỏ hơn hoặc bằng 0 (không) phút

Lưu ý

Trước khi bật nhật ký V2 (bản xem trước), hãy đảm bảo rằng bạn có đủ dung lượng cơ sở dữ liệu hỗ trợ cài đặt lưu giữ dữ liệu và phù hợp với kế hoạch dung lượng, quyền của bạn và điều chỉnh khi cần thiết. Dataverse Xem phần Mẫu Dataverse tính toán nhu cầu công suất cho các bản ghi V2 sau để biết một số ví dụ về kích thước.

Sự khác biệt chính của nhật ký dòng màn hình nền V1 và V2

Bảng sau đây mô tả sự khác biệt giữa nhật ký dòng màn hình nền V1 và V2:

Đặc điểm	Nhật ký V1	Nhật ký V2	Thông tin chi tiết
Lưu trữ dữ liệu tự động	Không có sẵn	Có mặt	V2 sử dụng Elastic Tables, được hỗ trợ bởi Azure Cosmos DB và đi kèm tính năng thời gian tồn tại tích hợp để tự động lưu giữ dữ liệu.
Hỗ trợ cho các kích thước nhật ký lớn	Khoảng 50.000 đến 80.000 nhật ký hành động (tối đa)	Khoảng gấp đôi số lượng nhật ký hành động V1 (ban đầu)	Về mặt lý thuyết, V2 có thể mở rộng quy mô lên tới hàng gigabyte nhật ký hành động cho mỗi lần chạy trong tương lai, trong khi V1 chỉ có thể mở rộng quy mô theo khối lượng được chỉ định trong bảng này.
Hỗ trợ báo cáo và quản trị nâng cao	Không có sẵn	Có mặt	Trong V1, thuộc tính AdditionalContext là một loại tệp, được lưu trữ dưới dạng blob trong Dataverse, khiến việc phân tích cú pháp để kiểm soát báo cáo và quản trị trở nên khó khăn. Nhật ký có thể truy cập được nhiều hơn trong V2.
Hỗ trợ tích hợp Azure Synapse Link for Dataverse	Không có sẵn	Có mặt	Trong V1, thuộc tính AdditionalContext là một loại tệp, được lưu trữ dưới dạng blob trong Dataverse, không được hỗ trợ để đồng bộ hóa Azure Synapse.
Hỗ trợ cho việc kiểm toán Dataverse	Không có sẵn	Có mặt	Trong V1, thuộc tính AdditionalContext là một loại tệp, được lưu trữ dưới dạng blob trong Dataverse, không được hỗ trợ trong Dataverse kiểm tra.
Hỗ trợ cho việc lưu giữ lâu dài Dataverse	Không có sẵn	Đã lên kế hoạch	Trong V1, thuộc tính AdditionalContext là một loại tệp, được lưu trữ dưới dạng blob trong Dataverse, không được hỗ trợ trong Dataverse việc lưu giữ dài hạn.
Dựa trên Dataverse Kiểm soát truy cập dựa trên vai trò (RBAC)	Có mặt	Có mặt	Cả hai phiên bản đều sử dụng Dataverse RBAC, kế thừa quyền nhật ký hành động từ bản ghi phiên dòng chính của chúng.

Logs V2 cung cấp những cải tiến đáng kể so với phiên bản trước đó là V1. V2 sử dụng tính năng bảng đàn hồi , rất phù hợp để xử lý khối lượng dữ liệu lớn, như các tình huống nhật ký hành động và có chức năng lưu giữ dữ liệu (TTL) tích hợp. Lý tưởng cho các tổ chức cần truy cập vào lượng dữ liệu lớn để báo cáo, quản lý và tích hợp với chức năng kiểm soát lưu giữ dữ liệu tự động.

Dataverse tính toán nhu cầu công suất cho các bản ghi V2 (bản xem trước)

Bảng sau đây hiển thị ước tính mức tiêu thụ dung lượng lưu trữ cơ sở dữ liệu mẫu cho mỗi lần chạy dòng màn hình nền khi sử dụng nhật ký V2. Dataverse Nó phác thảo nhu cầu lưu trữ gần đúng cho số lượng hành động khác nhau, giả sử trung bình là 3 KB dung lượng lưu trữ cho mỗi hành động.

Số lượng hành động	Nhu cầu lưu trữ cho mỗi hành động (KB)	Tổng dung lượng lưu trữ tiêu thụ (MB)
1,000	3	2.93
10,000	3	29.3
30,000	3	87.9
60,000	3	175.8
100,000	3	293
160,000	3	480

Quan trọng

Các số liệu hiển thị trong bảng trên chỉ là ước tính và mức tiêu thụ lưu trữ thực tế có thể thay đổi đáng kể. Nhu cầu lưu trữ chính xác sẽ phụ thuộc vào chi tiết cụ thể và độ phức tạp của từng nhật ký hành động. Do đó, bạn nên sử dụng những con số này như một hướng dẫn sơ bộ để hiểu được nhu cầu lưu trữ tiềm năng và lập kế hoạch lưu trữ phù hợp.

Truy vấn dữ liệu nhật ký V2 (bản xem trước)

Có thể truy cập dữ liệu nhật ký hành động dòng màn hình nền bằng cách thực hiện lệnh gọi API đến phần phụ trợ, sử dụng cú pháp lệnh gọi API truyền thống hoặc sử dụng phương thức Dataverse ExecuteCosmosSqlQuery mới. Phương pháp này cho phép bạn thực hiện truy vấn SQL đối với Dataverse, cho phép truy xuất và lọc dữ liệu.

Mô hình dữ liệu của nhật ký V2 dựa trên mối quan hệ cha-con giữa các bảng Flow Session và Flow Log. Mỗi bản ghi đều kế thừa quyền từ bản ghi phiên dòng chính của nó. Để truy vấn nhật ký hành động của một lần chạy dòng màn hình nền cụ thể, bạn có thể sử dụng cú pháp truy vấn sau.

Cú pháp gọi API truyền thống Dataverse

Cuộc gọi API sau đây sẽ truy xuất phiên luồng cụ thể theo ID của phiên đó (9d51aa1f-315e-43ab-894f-bc445dfb049b) rồi truy cập nhật ký hành động liên quan bằng mối quan hệ flowsession_flowlog_parentobjectid .

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid

Cú pháp gọi API ExecuteCosmosSqlQuery mới sử dụng bảng FlowLogs

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,PartitionId=@p3,QueryParameters=@p4,PageSize=@p5)?
    @p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
    @p2: 'flowlog'
    @p3: 'flowsession_40590757-a9c0-4f4c-abfc-e2f389049d90'
    @p4: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p5: 50

Tìm hiểu thêm về cách truy vấn các cột JSON trong bảng đàn hồi.

Chia nhỏ cuộc gọi thành từng phần riêng biệt

URL cơ sở (https://[tổ chức của tôi].api.crm[khu vực của tôi].dynamics.com/api/data/v9.2/) là điểm cuối cho Dataverse Web API.
ExecuteCosmosSqlQuery là phương thức đang được gọi. Phương pháp này cho phép thực hiện truy vấn SQL đối với Dataverse.
Các tham số cho phương thức ExecuteCosmosSqlQuery được cung cấp trong dấu ngoặc đơn theo sau tên phương thức. Đó là:
- QueryText=@p1: Truy vấn SQL sẽ được thực thi. Trong trường hợp này, truy vấn sẽ chọn nhiều thuộc tính khác nhau từ bảng có loại là 100000001 (dòng màn hình nền loại nhật ký hành động) và sắp xếp kết quả theo thuộc tính startTime theo thứ tự giảm dần.
- EntityLogicalName=@p2: Đây là tên logic của bảng (flowlog) lưu trữ nhật ký hành động.
- PartitionId=@p3: Tham số này được sử dụng để xác định phân vùng trong Azure Cosmos DB nơi truy vấn sẽ được thực thi. Nó được đặt thành flowsession_[flowsessionid].
- QueryParameters=@p4: Đây là đối tượng JSON chỉ định các tham số cho truy vấn. Trong ví dụ trước, nó chỉ định một cặp khóa-giá trị trong đó các khóa là @referencingParentId và @referencingParentLogicalName có giá trị là flowsessionid (GUID) và loại bảng flowsession.
- PageSize=p5: Đây là kích thước trang truy vấn.

Các hạn chế đã biết

Nhật ký V2 (bản xem trước) chỉ khả dụng cho các lần chạy dòng màn hình nền được khởi chạy từ dòng đám mây thông qua hành động kết nối dòng màn hình nền.
Việc thay đổi phiên bản nhật ký hành động sẽ không di chuyển các nhật ký hành động dòng màn hình nền trước đó sang loại lưu trữ nhật ký mới.

Chia sẻ qua