Skip to content

[DPE-9070] Handle pgBackRest archive timeout in check_stanza#1350

Merged
marceloneppel merged 1 commit intodpe-8865-extract-error-messagesfrom
dpe-9070-port-archive-timeout-check
Dec 15, 2025
Merged

[DPE-9070] Handle pgBackRest archive timeout in check_stanza#1350
marceloneppel merged 1 commit intodpe-8865-extract-error-messagesfrom
dpe-9070-port-archive-timeout-check

Conversation

@marceloneppel
Copy link
Member

@marceloneppel marceloneppel commented Dec 12, 2025

Issue

The archive timeout error handling (error code 82) from PR #1328 to allow users to fix network issues and retry with juju resolve was not added to PG 16.

Solution

When archive operations timeout, the charm enters error state instead of blocked state, enabling recovery via juju resolve. Fixes #1346

#1320 must be merged before this PR.

Checklist

  • I have added or updated any relevant documentation.
  • I have cleaned any remaining cloud resources from my accounts.

Port archive timeout error handling (error code 82) from PR #1328 to
allow users to fix network issues and retry with `juju resolve`.
When archive operations timeout, the charm enters error state instead
of blocked state, enabling recovery via juju resolve.
Fixes #1346

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
@github-actions github-actions bot added the Libraries: Out of sync The charm libs used are out-of-sync label Dec 12, 2025
@codecov
Copy link

codecov bot commented Dec 12, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 70.58%. Comparing base (6928787) to head (2133d09).
⚠️ Report is 1 commits behind head on dpe-8865-extract-error-messages.

Additional details and impacted files
@@                         Coverage Diff                         @@
##           dpe-8865-extract-error-messages    #1350      +/-   ##
===================================================================
+ Coverage                            70.53%   70.58%   +0.04%     
===================================================================
  Files                                   16       16              
  Lines                                 4273     4280       +7     
  Branches                               690      691       +1     
===================================================================
+ Hits                                  3014     3021       +7     
  Misses                                1048     1048              
  Partials                               211      211              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@marceloneppel marceloneppel marked this pull request as ready for review December 12, 2025 19:41
Copy link
Contributor

@taurus-forever taurus-forever left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you!

@marceloneppel marceloneppel merged commit ac88cce into dpe-8865-extract-error-messages Dec 15, 2025
249 of 251 checks passed
@marceloneppel marceloneppel deleted the dpe-9070-port-archive-timeout-check branch December 15, 2025 11:31
marceloneppel added a commit that referenced this pull request Dec 16, 2025
* Extract warning and error messages from pgBackRest logs

Sometimes the error message is sent to the stdout instead of the stderr, so it's important to check both

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Use semicolon separator for pgBackRest error messages

Concatenate multiple ERROR/WARN lines with "; " instead of " " for
improved readability when debugging backup issues.
Updated unit test to match new separator format.
Cherry-picked from #1328 (commit 1f1b601).

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* [DPE-9070] Handle pgBackRest archive timeout in check_stanza (#1350)

Port archive timeout error handling (error code 82) from PR #1328 to
allow users to fix network issues and retry with `juju resolve`.
When archive operations timeout, the charm enters error state instead
of blocked state, enabling recovery via juju resolve.
Fixes #1346

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Standardize pgBackRest logging to use stderr consistently

Addresses code review feedback from PR #1320 (review #3577653265) about
potential log duplication when checking both stdout and stderr for errors.

Changes:
- Add PGBACKREST_LOG_LEVEL_STDERR constant (--log-level-stderr=warn) to
  ensure all pgBackRest commands output errors/warnings to stderr
- Update all 9 pgBackRest command invocations to include the new flag
- Simplify _extract_error_message() to only check stderr (removes stdout
  parameter entirely)
- Update all 8 call sites and 7 unit tests to use new single-parameter API
- Remove redundant test for stdout handling

This approach eliminates the risk of log duplication while maintaining
predictable error extraction. All errors and warnings now consistently
appear in stderr, making error handling more reliable.

Reference: https://pgbackrest.org/configuration.html#section-log
Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Revert "Standardize pgBackRest logging to use stderr consistently"

This reverts commit 13a9ac4.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Reapply "Standardize pgBackRest logging to use stderr consistently"

This reverts commit 1c3eb04.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Fix test_initialise_stanza and cleanup unused variables

- Add --log-level-stderr=warn to test_initialise_stanza expected command to
  match implementation from commit d3a46b6
- Replace unused stdout variables with '_' in check_stanza,
  _is_primary_pgbackrest_service_running, and _on_restore_action
- Add --log-level-console=debug to backup command for detailed output
Fixes assertion error in tests/unit/test_backups.py::test_initialise_stanza

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

---------

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
a-velasco pushed a commit that referenced this pull request Jan 15, 2026
* Extract warning and error messages from pgBackRest logs

Sometimes the error message is sent to the stdout instead of the stderr, so it's important to check both

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Use semicolon separator for pgBackRest error messages

Concatenate multiple ERROR/WARN lines with "; " instead of " " for
improved readability when debugging backup issues.
Updated unit test to match new separator format.
Cherry-picked from #1328 (commit 1f1b601).

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* [DPE-9070] Handle pgBackRest archive timeout in check_stanza (#1350)

Port archive timeout error handling (error code 82) from PR #1328 to
allow users to fix network issues and retry with `juju resolve`.
When archive operations timeout, the charm enters error state instead
of blocked state, enabling recovery via juju resolve.
Fixes #1346

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Standardize pgBackRest logging to use stderr consistently

Addresses code review feedback from PR #1320 (review #3577653265) about
potential log duplication when checking both stdout and stderr for errors.

Changes:
- Add PGBACKREST_LOG_LEVEL_STDERR constant (--log-level-stderr=warn) to
  ensure all pgBackRest commands output errors/warnings to stderr
- Update all 9 pgBackRest command invocations to include the new flag
- Simplify _extract_error_message() to only check stderr (removes stdout
  parameter entirely)
- Update all 8 call sites and 7 unit tests to use new single-parameter API
- Remove redundant test for stdout handling

This approach eliminates the risk of log duplication while maintaining
predictable error extraction. All errors and warnings now consistently
appear in stderr, making error handling more reliable.

Reference: https://pgbackrest.org/configuration.html#section-log
Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Revert "Standardize pgBackRest logging to use stderr consistently"

This reverts commit 13a9ac4.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Reapply "Standardize pgBackRest logging to use stderr consistently"

This reverts commit 1c3eb04.

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

* Fix test_initialise_stanza and cleanup unused variables

- Add --log-level-stderr=warn to test_initialise_stanza expected command to
  match implementation from commit d3a46b6
- Replace unused stdout variables with '_' in check_stanza,
  _is_primary_pgbackrest_service_running, and _on_restore_action
- Add --log-level-console=debug to backup command for detailed output
Fixes assertion error in tests/unit/test_backups.py::test_initialise_stanza

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>

---------

Signed-off-by: Marcelo Henrique Neppel <marcelo.neppel@canonical.com>
Signed-off-by: andreia <andreia.velasco@canonical.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Libraries: Out of sync The charm libs used are out-of-sync

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants