From: Dominik Csapak <d.csapak@proxmox.com>
To: pdm-devel@lists.proxmox.com
Subject: [pdm-devel] [RFC PATCH datacenter-manager 2/2] ui: pbs: snapshot list: change to streaming 'content' api call
Date: Wed, 8 Oct 2025 15:54:05 +0200 [thread overview]
Message-ID: <20251008135558.3586369-3-d.csapak@proxmox.com> (raw)
In-Reply-To: <20251008135558.3586369-1-d.csapak@proxmox.com>
this changes the logic to add elements to the tree a bit, since we now
also show the namespaces in a true tree fashion.
We also have to adapt the sorting logic a bit, since now groups can sit
alongside namespaces.
We also collect all streaming errors we encounter and show a counter on
the bottom.
There are several things to improve here still:
* show the streaming errors in a popup when clicking on the message
* construct tree nodes on demand if the elements come out of order, or a
snapshot is listed without it's corresponding group, etc.
* add a 'cancel' button for long running requests
* change the namespace selection, either:
- add a max-depth selection too with a sensible default
- make the list load only one level at a time and fetch additional
levels on expanding a namespace
- simply remove the namespace selector
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
ui/src/pbs/snapshot_list.rs | 148 +++++++++++++++++++++++++-----------
1 file changed, 103 insertions(+), 45 deletions(-)
diff --git a/ui/src/pbs/snapshot_list.rs b/ui/src/pbs/snapshot_list.rs
index b82ffd5c..9f82054e 100644
--- a/ui/src/pbs/snapshot_list.rs
+++ b/ui/src/pbs/snapshot_list.rs
@@ -21,9 +21,11 @@ use pwt::widget::data_table::{DataTable, DataTableColumn, DataTableHeader};
use pwt::widget::{error_message, Column, Container, Fa, Progress, Toolbar, Tooltip};
use pwt::{css, AsyncPool};
-use pbs_api_types::{BackupGroup, BackupNamespace, BackupType, SnapshotListItem, VerifyState};
+use pbs_api_types::{
+ BackupGroup, BackupNamespace, BackupType, DatastoreContent, SnapshotListItem, VerifyState,
+};
-use proxmox_yew_comp::http_stream::Stream;
+use proxmox_yew_comp::http_stream::{Record, Stream};
use crate::locale_compare;
use crate::pbs::namespace_selector::NamespaceSelector;
@@ -59,16 +61,20 @@ struct SnapshotVerifyCount {
#[derive(PartialEq, Clone)]
enum SnapshotTreeEntry {
Root(BackupNamespace),
- Group(BackupGroup, SnapshotVerifyCount),
- Snapshot(SnapshotListItem),
+ Group(BackupNamespace, BackupGroup, SnapshotVerifyCount),
+ Snapshot(BackupNamespace, SnapshotListItem),
}
impl ExtractPrimaryKey for SnapshotTreeEntry {
fn extract_key(&self) -> Key {
match self {
SnapshotTreeEntry::Root(namespace) => Key::from(format!("root+{namespace}")),
- SnapshotTreeEntry::Group(group, _) => Key::from(format!("group+{group}")),
- SnapshotTreeEntry::Snapshot(entry) => Key::from(entry.backup.to_string()),
+ SnapshotTreeEntry::Group(namespace, group, _) => {
+ Key::from(format!("ns+{namespace}+group+{group}"))
+ }
+ SnapshotTreeEntry::Snapshot(namespace, entry) => {
+ Key::from(format!("ns+{namespace}+snap+{}", entry.backup))
+ }
}
}
}
@@ -77,7 +83,7 @@ impl ExtractPrimaryKey for SnapshotTreeEntry {
enum Msg {
SelectionChange,
ConsumeBuffer,
- UpdateBuffer(SnapshotListItem),
+ UpdateBuffer(Record<DatastoreContent>),
UpdateParentNamespace(Key),
Reload,
LoadFinished(Result<(), Error>),
@@ -89,7 +95,8 @@ struct SnapshotListComp {
_async_pool: AsyncPool,
columns: Rc<Vec<DataTableHeader<SnapshotTreeEntry>>>,
load_result: Option<Result<(), Error>>,
- buffer: Vec<SnapshotListItem>,
+ buffer: Vec<DatastoreContent>,
+ errors: Vec<serde_json::Value>,
current_namespace: BackupNamespace,
interval: Option<Interval>,
}
@@ -109,7 +116,7 @@ impl SnapshotListComp {
("object-group", tr!("Namespace '{0}'", namespace))
}
}
- SnapshotTreeEntry::Group(group, _) => (
+ SnapshotTreeEntry::Group(_, group, _) => (
match group.ty {
BackupType::Vm => "desktop",
BackupType::Ct => "cube",
@@ -117,7 +124,9 @@ impl SnapshotListComp {
},
group.to_string(),
),
- SnapshotTreeEntry::Snapshot(entry) => ("file-o", entry.backup.to_string()),
+ SnapshotTreeEntry::Snapshot(_, entry) => {
+ ("file-o", entry.backup.to_string())
+ }
};
render_tree_column(Fa::new(icon).fixed_width().into(), res).into()
})
@@ -126,10 +135,10 @@ impl SnapshotListComp {
.justify("right")
.render(|item: &SnapshotTreeEntry| match item {
SnapshotTreeEntry::Root(_) => "".into(),
- SnapshotTreeEntry::Group(_group, counts) => {
+ SnapshotTreeEntry::Group(_ns, _group, counts) => {
(counts.ok + counts.failed + counts.none).into()
}
- SnapshotTreeEntry::Snapshot(_entry) => "".into(),
+ SnapshotTreeEntry::Snapshot(_ns, _entry) => "".into(),
})
.into(),
DataTableColumn::new(tr!("Verify State"))
@@ -145,6 +154,8 @@ impl SnapshotListComp {
.write()
.set_root(SnapshotTreeEntry::Root(self.current_namespace.clone()));
self._async_pool = AsyncPool::new();
+ self.buffer.clear();
+ self.errors.clear();
self.reload(ctx);
}
@@ -193,6 +204,7 @@ impl Component for SnapshotListComp {
_async_pool: AsyncPool::new(),
load_result: None,
buffer: Vec::new(),
+ errors: Vec::new(),
current_namespace: BackupNamespace::root(),
interval: None,
};
@@ -216,50 +228,90 @@ impl Component for SnapshotListComp {
}
let now = (Date::now() / 1000.0) as i64;
+ // TODO: handle out of order items
+ // we have to create the intermediate tree nodes if items are received out of order
+
for item in data {
- let group = item.backup.group.to_string();
- let mut group = if let Some(group) =
- root.find_node_by_key_mut(&Key::from(format!("group+{group}")))
- {
- group
- } else {
- root.append(SnapshotTreeEntry::Group(
- item.backup.group.clone(),
- Default::default(),
- ))
- };
- if let SnapshotTreeEntry::Group(_, verify_state) = group.record_mut() {
- match item.verification.as_ref() {
- Some(state) => {
- match state.state {
- VerifyState::Ok => verify_state.ok += 1,
- VerifyState::Failed => verify_state.failed += 1,
+ let (ns, item) = match item {
+ DatastoreContent::NameSpace(ns) => {
+ let ns = ns.ns;
+ let ns_entry = SnapshotTreeEntry::Root(ns.clone());
+ if root.find_node_by_key_mut(&ns_entry.extract_key()).is_some() {
+ // already inserted
+ continue;
+ }
+
+ let parent = SnapshotTreeEntry::Root(ns.parent());
+ if let Some(mut parent) =
+ root.find_node_by_key_mut(&parent.extract_key())
+ {
+ parent.append(ns_entry);
+ }
+ continue;
+ }
+ DatastoreContent::Group(group) => {
+ let ns = SnapshotTreeEntry::Root(group.ns.clone());
+ if let Some(mut ns) = root.find_node_by_key_mut(&ns.extract_key()) {
+ let group_entry = SnapshotTreeEntry::Group(
+ group.ns,
+ group.group.backup,
+ Default::default(),
+ );
+ if ns.find_node_by_key(&group_entry.extract_key()).is_none() {
+ ns.append(group_entry);
}
+ }
+
+ continue;
+ }
+ DatastoreContent::Snapshot(snapshot) => (snapshot.ns, snapshot.snapshot),
+ };
- let age_days = (now - state.upid.starttime) / (30 * 24 * 60 * 60);
- if age_days > 30 {
- verify_state.outdated += 1;
+ let group = SnapshotTreeEntry::Group(
+ ns.clone(),
+ item.backup.group.clone(),
+ Default::default(),
+ );
+ if let Some(mut group) = root.find_node_by_key_mut(&group.extract_key()) {
+ if let SnapshotTreeEntry::Group(_, _, verify_state) = group.record_mut() {
+ match item.verification.as_ref() {
+ Some(state) => {
+ match state.state {
+ VerifyState::Ok => verify_state.ok += 1,
+ VerifyState::Failed => verify_state.failed += 1,
+ }
+
+ let age_days =
+ (now - state.upid.starttime) / (30 * 24 * 60 * 60);
+ if age_days > 30 {
+ verify_state.outdated += 1;
+ }
}
+ None => verify_state.none += 1,
}
- None => verify_state.none += 1,
}
- }
- group.append(SnapshotTreeEntry::Snapshot(item));
+ group.append(SnapshotTreeEntry::Snapshot(ns, item));
+ };
}
store.sort_by(true, |a, b| match (a, b) {
- (SnapshotTreeEntry::Group(a, _), SnapshotTreeEntry::Group(b, _)) => {
+ (SnapshotTreeEntry::Root(a), SnapshotTreeEntry::Root(b)) => a.cmp(b),
+ (SnapshotTreeEntry::Root(_), _) => std::cmp::Ordering::Less,
+ (SnapshotTreeEntry::Group(_, a, _), SnapshotTreeEntry::Group(_, b, _)) => {
locale_compare(a.to_string(), &b.to_string(), true)
}
- (SnapshotTreeEntry::Snapshot(a), SnapshotTreeEntry::Snapshot(b)) => {
+ (SnapshotTreeEntry::Snapshot(_, a), SnapshotTreeEntry::Snapshot(_, b)) => {
a.backup.cmp(&b.backup)
}
- _ => std::cmp::Ordering::Less,
+ _ => std::cmp::Ordering::Equal,
});
true
}
Msg::UpdateBuffer(item) => {
- self.buffer.push(item);
+ match item {
+ Record::Data(data) => self.buffer.push(data),
+ Record::Error(err) => self.errors.push(err),
+ }
false
}
Msg::UpdateParentNamespace(ns_key) => {
@@ -294,6 +346,11 @@ impl Component for SnapshotListComp {
_ => None,
};
+ let err_count = self.errors.len();
+ let streaming_err = (err_count > 0).then_some(error_message(&tr!(
+ "One error during streaming" | "{n} errors during streaming" % err_count
+ )));
+
let link = ctx.link();
let props = ctx.props();
@@ -333,6 +390,7 @@ impl Component for SnapshotListComp {
.selection(self.selection.clone()),
)
.with_optional_child(err.map(|err| error_message(&err.to_string())))
+ .with_optional_child(streaming_err)
.into()
}
}
@@ -341,12 +399,12 @@ async fn list_snapshots(
remote: String,
datastore: String,
namespace: BackupNamespace,
- callback: yew::Callback<SnapshotListItem>,
+ callback: yew::Callback<Record<DatastoreContent>>,
) -> Result<(), Error> {
let path = if namespace.is_root() {
- format!("/api2/json/pbs/remotes/{remote}/datastore/{datastore}/snapshots")
+ format!("/api2/json/pbs/remotes/{remote}/datastore/{datastore}/content")
} else {
- format!("/api2/json/pbs/remotes/{remote}/datastore/{datastore}/snapshots?ns={namespace}")
+ format!("/api2/json/pbs/remotes/{remote}/datastore/{datastore}/content?ns={namespace}")
};
// TODO: refactor application/json-seq helper for general purpose use
@@ -368,7 +426,7 @@ async fn list_snapshots(
let mut stream = Stream::try_from(raw_reader)?;
- while let Some(entry) = stream.next::<pbs_api_types::SnapshotListItem>().await? {
+ while let Some(entry) = stream.next::<Record<DatastoreContent>>().await? {
callback.emit(entry);
}
@@ -379,7 +437,7 @@ fn render_verification(entry: &SnapshotTreeEntry) -> Html {
let now = (Date::now() / 1000.0) as i64;
match entry {
SnapshotTreeEntry::Root(_) => "".into(),
- SnapshotTreeEntry::Group(_, verify_state) => {
+ SnapshotTreeEntry::Group(_, _, verify_state) => {
let text;
let icon_class;
let tip;
@@ -430,7 +488,7 @@ fn render_verification(entry: &SnapshotTreeEntry) -> Html {
.tip(tip)
.into()
}
- SnapshotTreeEntry::Snapshot(entry) => match &entry.verification {
+ SnapshotTreeEntry::Snapshot(_, entry) => match &entry.verification {
Some(state) => {
let age_days = (now - state.upid.starttime) / (30 * 24 * 60 * 60);
let (text, icon_class, class) = match state.state {
--
2.47.3
_______________________________________________
pdm-devel mailing list
pdm-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pdm-devel
prev parent reply other threads:[~2025-10-08 13:56 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-10-08 13:54 [pdm-devel] [RFC PATCH datacenter-manager 0/2] use streaming content api Dominik Csapak
2025-10-08 13:54 ` [pdm-devel] [RFC PATCH datacenter-manager 1/2] server: add new streaming 'content' api call for pbs Dominik Csapak
2025-10-08 13:54 ` Dominik Csapak [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20251008135558.3586369-3-d.csapak@proxmox.com \
--to=d.csapak@proxmox.com \
--cc=pdm-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox