Class: Parse::PushStatus

Inherits:
Object
  • Object
show all
Defined in:
lib/parse/model/classes/push_status.rb

Overview

Note:

_PushStatus is hardcoded master-key-only at Parse Server's REST layer (SharedRest.js). CLP changes via Object.set_clp have no effect — all reads and writes require a master-key client.

This class represents the data and columns contained in the standard Parse _PushStatus collection. Push status records track the delivery status and metrics of push notifications sent through Parse Server.

Push status records are created automatically when a push is sent and are updated as the push progresses through the delivery pipeline.

Status lifecycle: pending → scheduled → running → succeeded/failed

The default schema for the PushStatus class is as follows: class Parse::PushStatus < Parse::Object # See Parse::Object for inherited properties...

 property :push_hash        # Unique hash identifying the push
 property :query, :object   # The query used to target installations
 property :payload, :object # The push payload that was sent
 property :source           # "rest" or "webUI"
 property :status           # "pending", "scheduled", "running", "succeeded", "failed"
 property :num_sent, :integer
 property :num_failed, :integer
 property :sent_per_type, :object
 property :failed_per_type, :object
 property :sent_per_utc_offset, :object
 property :failed_per_utc_offset, :object
 property :count, :integer  # Total installations targeted
 property :push_time, :date # When the push was/will be sent
 property :expiry, :date    # When the push expires

end

Examples:

Checking push status

status = Parse::PushStatus.find(push_id)
puts "Sent: #{status.num_sent}, Failed: #{status.num_failed}"
puts "Status: #{status.status}"

Querying recent pushes

recent = Parse::PushStatus.recent.limit(10).all
recent.each { |s| puts "#{s.status}: #{s.num_sent} sent" }

See Also:

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#count ⇒ Integer

Total number of installations targeted by this push.

Returns:

  • (Integer) —

    The target count.



118
 
# File 'lib/parse/model/classes/push_status.rb', line 118

property :count, :integer

#error_message ⇒ String?

Error message if the push failed.

Returns:

  • (String, nil) —

    The error message or nil.



133
 
# File 'lib/parse/model/classes/push_status.rb', line 133

property :error_message

#expiry ⇒ Parse::Date

When the push expires and will no longer be delivered.

Returns:



128
 
# File 'lib/parse/model/classes/push_status.rb', line 128

property :expiry, :date

#failed_per_type ⇒ Hash

Breakdown of failed sends by device type.

Returns:

  • (Hash) —

    Device type to count mapping.



101
 
# File 'lib/parse/model/classes/push_status.rb', line 101

property :failed_per_type, :object

#failed_per_utc_offset ⇒ Hash

Breakdown of failed sends by UTC timezone offset.

Returns:

  • (Hash) —

    UTC offset to count mapping.



113
 
# File 'lib/parse/model/classes/push_status.rb', line 113

property :failed_per_utc_offset, :object

#num_failed ⇒ Integer

The number of notifications that failed to send.

Returns:

  • (Integer) —

    The failure count.



89
 
# File 'lib/parse/model/classes/push_status.rb', line 89

property :num_failed, :integer

#num_sent ⇒ Integer

The number of notifications successfully sent.

Returns:

  • (Integer) —

    The success count.



84
 
# File 'lib/parse/model/classes/push_status.rb', line 84

property :num_sent, :integer

#payload ⇒ Hash

The push payload that was sent.

Returns:

  • (Hash) —

    The payload data.



68
 
# File 'lib/parse/model/classes/push_status.rb', line 68

property :payload, :object

#push_hash ⇒ String

A unique hash identifying this push notification.

Returns:



58
 
# File 'lib/parse/model/classes/push_status.rb', line 58

property :push_hash

#push_time ⇒ Parse::Date

When the push was/will be sent. For scheduled pushes, this is the future time.

Returns:



123
 
# File 'lib/parse/model/classes/push_status.rb', line 123

property :push_time, :date

#query ⇒ Hash

The query constraints used to target installations.

Returns:

  • (Hash) —

    The query constraint hash.



63
 
# File 'lib/parse/model/classes/push_status.rb', line 63

property :query, :object

#sent_per_type ⇒ Hash

Breakdown of successful sends by device type (ios, android, etc.).

Examples:

status.sent_per_type  # => {"ios" => 800, "android" => 450}

Returns:

  • (Hash) —

    Device type to count mapping.



96
 
# File 'lib/parse/model/classes/push_status.rb', line 96

property :sent_per_type, :object

#sent_per_utc_offset ⇒ Hash

Breakdown of successful sends by UTC timezone offset.

Examples:

status.sent_per_utc_offset  # => {"-8" => 500, "0" => 300, "5" => 200}

Returns:

  • (Hash) —

    UTC offset to count mapping.



108
 
# File 'lib/parse/model/classes/push_status.rb', line 108

property :sent_per_utc_offset, :object

#source ⇒ String

The source of the push ("rest" for API, "webUI" for dashboard).

Returns:

  • (String) —

    The push source.



73
 
# File 'lib/parse/model/classes/push_status.rb', line 73

property :source

#status ⇒ String

The current status of the push. One of: "pending", "scheduled", "running", "succeeded", "failed"

Returns:

  • (String) —

    The push status.



79
 
# File 'lib/parse/model/classes/push_status.rb', line 79

property :status

Class Method Details

.failed ⇒ Parse::Query

Query for failed pushes.

Returns:



166
167
168
 
# File 'lib/parse/model/classes/push_status.rb', line 166

def failed
  query(status: "failed")
end

.pending ⇒ Parse::Query

Query for pending pushes (not yet started).

Returns:



142
143
144
 
# File 'lib/parse/model/classes/push_status.rb', line 142

def pending
  query(status: "pending")
end

.recent ⇒ Parse::Query

Query for recent pushes, ordered by creation time descending.

Returns:



172
173
174
 
# File 'lib/parse/model/classes/push_status.rb', line 172

def recent
  query.order(:created_at.desc)
end

.running ⇒ Parse::Query

Query for running pushes (currently being sent).

Returns:



154
155
156
 
# File 'lib/parse/model/classes/push_status.rb', line 154

def running
  query(status: "running")
end

.scheduled ⇒ Parse::Query

Query for scheduled pushes (waiting for push_time).

Returns:



148
149
150
 
# File 'lib/parse/model/classes/push_status.rb', line 148

def scheduled
  query(status: "scheduled")
end

.succeeded ⇒ Parse::Query

Query for succeeded pushes.

Returns:



160
161
162
 
# File 'lib/parse/model/classes/push_status.rb', line 160

def succeeded
  query(status: "succeeded")
end

Instance Method Details

#complete? ⇒ Boolean

Check if the push is complete (either succeeded or failed).

Returns:

  • (Boolean) —

    true if the push has finished



213
214
215
 
# File 'lib/parse/model/classes/push_status.rb', line 213

def complete?
  succeeded? || failed?
end

#failed? ⇒ Boolean

Check if the push failed.

Returns:

  • (Boolean) —

    true if status is "failed"



207
208
209
 
# File 'lib/parse/model/classes/push_status.rb', line 207

def failed?
  status == "failed"
end

#failure_rate ⇒ Float

Get the failure rate as a percentage.

Returns:

  • (Float) —

    the failure rate (0.0 to 100.0)



245
246
247
 
# File 'lib/parse/model/classes/push_status.rb', line 245

def failure_rate
  100.0 - success_rate
end

#in_progress? ⇒ Boolean

Check if the push is still in progress.

Returns:

  • (Boolean) —

    true if pending, scheduled, or running



219
220
221
 
# File 'lib/parse/model/classes/push_status.rb', line 219

def in_progress?
  !complete?
end

#pending? ⇒ Boolean

Check if the push is pending (not yet started).

Returns:

  • (Boolean) —

    true if status is "pending"



183
184
185
 
# File 'lib/parse/model/classes/push_status.rb', line 183

def pending?
  status == "pending"
end

#running? ⇒ Boolean

Check if the push is currently running.

Returns:

  • (Boolean) —

    true if status is "running"



195
196
197
 
# File 'lib/parse/model/classes/push_status.rb', line 195

def running?
  status == "running"
end

#scheduled? ⇒ Boolean

Check if the push is scheduled (waiting for push_time).

Returns:

  • (Boolean) —

    true if status is "scheduled"



189
190
191
 
# File 'lib/parse/model/classes/push_status.rb', line 189

def scheduled?
  status == "scheduled"
end

#succeeded? ⇒ Boolean

Check if the push succeeded.

Returns:

  • (Boolean) —

    true if status is "succeeded"



201
202
203
 
# File 'lib/parse/model/classes/push_status.rb', line 201

def succeeded?
  status == "succeeded"
end

#success_rate ⇒ Float

Get the success rate as a percentage.

Examples:

status.success_rate  # => 98.5

Returns:

  • (Float) —

    the success rate (0.0 to 100.0)



237
238
239
240
241
 
# File 'lib/parse/model/classes/push_status.rb', line 237

def success_rate
  total = total_attempted
  return 0.0 if total == 0
  ((num_sent || 0).to_f / total * 100).round(2)
end

#summary ⇒ Hash

Get a summary of the push metrics.

Examples:

status.summary
# => { status: "succeeded", sent: 1250, failed: 12, success_rate: 99.05 }

Returns:

  • (Hash) —

    summary hash with key metrics



254
255
256
257
258
259
260
261
262
263
264
 
# File 'lib/parse/model/classes/push_status.rb', line 254

def summary
  {
    status: status,
    sent: num_sent || 0,
    failed: num_failed || 0,
    total_targeted: count || 0,
    success_rate: success_rate,
    sent_per_type: sent_per_type || {},
    failed_per_type: failed_per_type || {},
  }
end

#total_attempted ⇒ Integer

Get the total number of notifications attempted (sent + failed).

Returns:

  • (Integer) —

    the total count



229
230
231
 
# File 'lib/parse/model/classes/push_status.rb', line 229

def total_attempted
  (num_sent || 0) + (num_failed || 0)
end