googleapis/google-cloud-python

Improve the Write logEntry sample

已關閉

#15,426 建立於 2020年12月10日

在 GitHub 查看貢獻者指南
 (1 則留言) (0 個反應) (0 位負責人)Python (1,481 個分叉)batch import
api: logginggood first issuepriority: p3samplestype: feature request

倉庫指標

星標
 (4,304 顆星)
PR 合併指標
 (平均合併 4天) (30 天內合併 158 個 PR)

描述

Improve the Write logEntry sample on this page

This page is referenced by docs that explicitly talk about LogEntries. So we should demo this “advanced” logging technique, even though we do recommend the standard log wrapper approach in the quickstarts.

Criteria:

  • Demo how to write a text logEntry (textPayload)
  • Demo how to write a struct logEntry (jsonPayload)
  • Include: severity level, labels, resource type (“global”)
  • Demo: batch logging vs writing one log at a time
  • Update accompanying tests

Region tag: logging_write_log_entry

貢獻者指南

研究方向
The issue requires improving the 'Write logEntry' sample at https://cloud.google.com/logging/docs/samples/logging write log entry. The criteria include demonstrating textPayload, jsonPayload, severity, labels, resource type, batch vs single logging, and updating tests. The region tag is 'logging write log entry'. Start by exploring the existing sample in the google cloud python repository, likely under the logging directory. Review the current test suite for that sample and understand how the Google Cloud Logging client library handles log entries. Ensure the new sample follows the established patterns and passes all tests.
技術棧
python
領域
documentationtesting
議題類型
文件
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 小時
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
較久未更新
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
清晰
前置要求
Basic PythonGoogle Cloud accountFamiliarity with Cloud Logging
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
60