Struct ServiceInstance 

pub struct ServiceInstance {
    pub id: String,
    pub service_name: String,
    pub host: String,
    pub port: u16,
    pub secure: bool,
    pub status: InstanceStatus,
    pub metadata: HashMap<String, String>,
    pub tags: Vec<String>,
    pub registered_at: DateTime<Utc>,
    pub last_heartbeat: DateTime<Utc>,
    pub last_status_change: DateTime<Utc>,
}

Represents a service instance in the ScoutQuest discovery system.

A service instance contains all the information needed to connect to and identify a specific instance of a service, including its network location, health status, and metadata.

Fields

id: String

Unique identifier for this service instance

service_name: String

Name of the service this instance belongs to

host: String

Hostname or IP address where the service is running

port: u16

Port number where the service is listening

secure: bool

Whether the service uses HTTPS/TLS

status: InstanceStatus

Current status of the service instance

metadata: HashMap<String, String>

Custom metadata key-value pairs

tags: Vec<String>

Tags associated with this service instance

registered_at: DateTime<Utc>

Timestamp when the service was first registered

last_heartbeat: DateTime<Utc>

Timestamp of the last heartbeat received

last_status_change: DateTime<Utc>

Timestamp when the status last changed

Implementations

impl ServiceInstance

pub fn is_healthy(&self) -> bool

Returns true if the service instance is healthy and ready to serve requests.

pub fn get_url(&self, path: &str) -> String

Constructs the full URL for a given path on this service instance.

Arguments

• path - The API path to append to the base URL

Returns

A complete URL string ready to be used for HTTP requests.

Examples

use scoutquest_rust::*;
use std::collections::HashMap;
use chrono::Utc;

let instance = ServiceInstance {
    id: "test-1".to_string(),
    service_name: "api".to_string(),
    host: "localhost".to_string(),
    port: 3000,
    secure: false,
    status: InstanceStatus::Up,
    metadata: HashMap::new(),
    tags: Vec::new(),
    registered_at: Utc::now(),
    last_heartbeat: Utc::now(),
    last_status_change: Utc::now(),
};

assert_eq!(instance.get_url("/users"), "http://localhost:3000/users");
assert_eq!(instance.get_url("users"), "http://localhost:3000/users");

Trait Implementations

impl Clone for ServiceInstance

fn clone(&self) -> ServiceInstance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServiceInstance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServiceInstance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ServiceInstance

fn eq(&self, other: &ServiceInstance) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServiceInstance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ServiceInstance