native_http_access_log.h

Go to the documentation of this file.

/**
 * @file
 * @brief Declares native access log and error log helpers.
 */
 
#ifndef PHAROS_NATIVE_HTTP_ACCESS_LOG_H
#define PHAROS_NATIVE_HTTP_ACCESS_LOG_H
 
#include "native_http_request.h"
 
/** @name HTTP access log helpers
 * @{
 */
/**
 * @brief Writes one structured error log entry and its paired JSONL error report.
 * @param log_path Access or runtime log path.
 * @param error_report_path Optional explicit JSONL error report path.
 * @param app_id App identifier associated with the failure.
 * @param request Request associated with the failure.
 * @param request_path Normalized request path.
 * @param status_text HTTP status line or reason text.
 * @param reason Stable failure reason label.
 * @param resource_path Resource path associated with the failure.
 * @param detail_text Optional detail text to include.
 */
void native_write_error_log(const char *log_path, const char *error_report_path, const char *app_id, const HttpRequest *request, const char *request_path, const char *status_text, const char *reason, const char *resource_path, const char *detail_text);
/**
 * @brief Writes one access log entry for a completed HTTP request.
 * @param log_path Access log file path.
 * @param request Request that was served.
 * @param request_path Normalized request path.
 * @param status_code Final HTTP status code.
 */
void native_write_access_log(const char *log_path, const HttpRequest *request, const char *request_path, int status_code);
 
/** @} */
#endif