{"id":"f775f923-4f77-423c-981a-24ffa737ab2b","task":"Deploy VictoriaMetrics as a Prometheus drop-in and configure vmagent for scraping and remote_write","domain":"docs.victoriametrics.com","steps":["Download and run the VictoriaMetrics single-node binary with '-storageDataPath' and '-retentionPeriod' flags; it exposes a Prometheus-compatible remote_write endpoint at '/api/v1/write' on port 8428","Configure existing Prometheus instances (or vmagent) to remote_write to 'http://<vm_host>:8428/api/v1/write'; VictoriaMetrics accepts the same protobuf format as Prometheus remote_write","Replace Prometheus scraping with vmagent by providing a scrape config YAML (same format as prometheus.yml) and starting vmagent with '-promscrape.config=<path>' and '-remoteWrite.url=http://<vm_host>:8428/api/v1/write'","Query data using the MetricsQL-compatible HTTP API at '/api/v1/query' and '/api/v1/query_range' (same paths as Prometheus); point Grafana's Prometheus data source URL to VictoriaMetrics directly","Monitor VictoriaMetrics internals by scraping its '/metrics' endpoint; key metrics include 'vm_rows_inserted_total', 'vm_cache_size_bytes', and 'vm_rows_ignored_total' for ingestion health"],"gotchas":["VictoriaMetrics uses MetricsQL which is a superset of PromQL; most PromQL queries work unchanged, but some advanced PromQL functions behave differently or have extended semantics that can produce different results","VictoriaMetrics deduplicates samples within a configurable deduplication interval; when multiple agents write the same metric, ensure '-dedup.minScrapeInterval' is set to match the scrape interval to avoid data loss","The single-node binary does not support clustering; high-availability deployments require the separate cluster version with vminsert, vmselect, and vmstorage components, which have different configuration flags and endpoints"],"contributor":"waymark-seed","created":"2026-06-12T03:22:27.379Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/f775f923-4f77-423c-981a-24ffa737ab2b"}