Hataları bildirin

Hataları otomatik olarak bildirme

Aşağıda gösterildiği gibi, bir Cloud Functions işlevinden Error Reporting'e hata gönderebilirsiniz:

Node.js

// These WILL be reported to Error Reporting
throw new Error('I failed you'); // Will cause a cold start if not caught

Python

@functions_framework.http
def hello_error_1(request):
    # This WILL be reported to Error Reporting,
    # and WILL NOT show up in logs or
    # terminate the function.
    from google.cloud import error_reporting

    client = error_reporting.Client()

    try:
        raise RuntimeError("I failed you")
    except RuntimeError:
        client.report_exception()

    # This WILL be reported to Error Reporting,
    # and WILL terminate the function
    raise RuntimeError("I failed you")


@functions_framework.http
def hello_error_2(request):
    # These errors WILL NOT be reported to Error
    # Reporting, but will show up in logs.
    import logging
    import sys

    print(RuntimeError("I failed you (print to stdout)"))
    logging.warning(RuntimeError("I failed you (logging.warning)"))
    logging.error(RuntimeError("I failed you (logging.error)"))
    sys.stderr.write("I failed you (sys.stderr.write)\n")

    # This is considered a successful execution and WILL NOT be reported
    # to Error Reporting, but the status code (500) WILL be logged.
    from flask import abort

    return abort(500)

Daha ayrıntılı hata raporlaması isterseniz Error Reporting istemci kitaplıkları'nı kullanabilirsiniz.

Bildirilen hataları GCP Console'daki Error Reporting bölümünde görüntüleyebilirsiniz. Belirli bir işlevle ilgili olarak bildirilen hataları, GCP Console'daki işlev listesinden seçtiğinizde de görebilirsiniz.

İşleviniz tarafından oluşturulan yakalanmamış istisnalar Hata Bildirimi'nde görünür. Bazı yakalanmamış istisna türlerinin (eşzamansız olarak atılanlar gibi) gelecekteki bir işlev çağrısında başlangıç noktasının oluşmasına neden olacağını unutmayın. Bu, işlevinizin çalışması için gereken süreyi artırır.

Hataları manuel olarak bildirme

Cloud Logging'e gönderiliyor

Cloud Functions logger SDK'sındaki error işlevi, hataları hem Cloud Logging'e hem de Error Reporting'e bildirir. Hatadan daha fazla bağlam bilgisi yapılandırılmış veri olarak eklemek için bir hata nesnesini ikinci bağımsız değişken olarak iletin:

} catch (err) {
  // Attach an error object as the second argument
  functions.logger.error(
    "Unable to read quote from Firestore, sending default instead",
    err
  );
}